If you apply maintenance that contains upgraded FMIDs but
does not contain features that require configuration changes, you
only need to refresh the work libraries (to update the version) and
load the read-only files from the SMP/E target libraries to the runtime
libraries.
About this task
If you are upgrading in place (that is using the same
target libraries and the same runtime product libraries, follow these
instructions. Otherwise, follow Scenario SMPE05: Upgrading an existing runtime environment with configuration changes but using IBM-supplied configuration defaults and
change the high-level qualifiers as appropriate.
Perform an upgrade with no configuration changes
involves the following steps:
- Refreshing the work libraries.
- Submitting the jobs that complete the setup of the RTE.
At a minimum, you need to copy the SMP/E target libraries to
the read-only runtime libraries (KCIJPLOD) and the updated work libraries
to the user libraries (KCIJPCPR and KCIJPW2R). You might need to run
additional jobs, depending upon product-specific requirements spelled
out in ++HOLD data.
Procedure
- Refresh the work libraries.
- From the Workflow main menu, select Set up
PARMGEN work environment for an RTE.
The
following message is displayed:
KCIP@MSG ---------------- PARMGEN MESSAGES --------------------------
Command ===>
While configuring an existing RTE profile, you have asked to
navigate to the KCIJPCFG option to review or make changes to the
KCIJPCFG job, which was run with highest condition code RC= 00000
on 2017/07/27. In most cases, if you change any KCIJPCFG
parameters, you will have to rerun the KCIJPCFG job and certain
subsequent PARMGEN configuration jobs.
Press ENTER to continue with KCIJPCFG changes.
Press F3 to abort.
- Press Enter to continue.
The first
setup panel (KCIP@PG1) is displayed.
- Step through the presented panels by pressing Enter
to accept the current configuration values. (On the Include
Products in this PARMGEN RTE panel, enter y to
confirm the current choices.)
After you confirm the current
product selection, you are prompted to provide a name for the backup
copy of the RTE profile.
- Provide a name for the backup, then press Enter.
The KCIJPCFG JCL is displayed.
- Review the notes, then submit the job.
The
KCIJPCFG job creates new RTE profiles that contains the new parameters,
then runs the KCIJPPRF job. The KCIJPPRF job updates the interim libraries
and merges the current values from the backed up profile into the
new profiles. Return to the main Workflow panel. Wait until both KCIJPCFG
and KCIJPPRF have completed before proceeding to the next step. No
return code is displayed on the Workflow main panel until both jobs
have completed.
- Submit the jobs to complete the setup of the RTE.
- Select Submit batch jobs to complete PARMGEN setup.
The Submit Batch Jobs to Complete PARMGEN Setup menu is displayed.
KCIP@SUB -------- SUBMIT BATCH JOBS TO COMPLETE PARMGEN SETUP -----------------
Option ===>
Select option 1 to SUBMIT the composite jobs in WKANSAMU for SYSA RTE.
Tip: Review the SUBMIT commands in the KCIJPSUB composite job.
Alternatively, select other options (2-12) to submit each job individually.
Enter ns (1s-12s) for detailed job/task status.
Description REQ Job Name Status Date
--------------------------------------- ----- -------- --------- ----------
More: +
1. Composite SUBMIT job (See JCL comments) KCIJPSUB
** or **
2. Allocate runtime RO and RW datasets (Yes) KCIJPALO
3. Copy SMP/E mbrs from TK*->RK* RO libs (Yes) KCIJPLOD
4. Run product security steps (Yes) KCIJPSEC
5. Update variable-named runtime mbrs (No ) KCIJPUPV
6. (Re)Create USS runtime mbrs in RKANDATV (Yes) KCIJPUSP
7. Create USS dirs./ (Re)Copy USS files (Yes) KCIJPUSS
8. Copy runtime mbrs to SYS1-type libs (Caution) KCIJPSYS
9. Run post-SMP/E RKANMODU ASM/LINK steps (Yes) KCIJPLNK
10. Verify the configuration jobs (Tip) KCIJPIVP
11. Back-up RK* product execution user libs (Tip) KCIJPCPR
12. Copy runtime mbrs from WK*->RK* RW libs (Yes) Enter 12 for details.
Press F1=Help for more information. Type UTIL to access utility menu.
- Submit the following jobs and any other jobs indicated
by a Yes in the REQ column.
- KCIJPLOD
- This required job copies members of the target libraries that
were installed by SMP/E to the read-only RK* libraries.
- KCIJPW2R/KCIJPW1R
- These jobs (Option 12) copies the WK* work output
libraries to the respective production RK* runtime libraries. If you run either of these jobs, run
KCIJPCPR to back up the RK* production libraries. KCIJPW2R is run by default when the composite
submit job KCIJPSUB is run. KCIJPW2R replaces all RK* members with members from WK*. It will leave
non-PARMGEN managed members in RK* libraries. KCIJPW1R deletes all RK* members except for the ones
that are added in the IBM provided WKANSAMU(KCI$IW2R) and user defined WCONFIG(KCI$XW2R) exclude
lists, and then copies WK* members to RK* libraries. You must add members they want saved to their
RTE WCONFIG(KCI$XW2R) member.
You might need to submit one or more of the following
jobs:
- KCIJPSEC (if upgrade introduces changes in security) to create
security-related members (load modules, encryption key, and other
elements) based on the product security requirements
- KCIJPALO (if the upgrade introduces new data sets are introduced)
- KCIJPUSP and KCIJcUSS (if upgrade introduces changes in z/OS®
UNIX System Services requirements)
- KCIJPLNK (if OMEGAMON for IMS on z/OS is installed)
- KCIJPSYS (if upgrade introduces new started tasks or nodes)