Scenario SMPE01: Applying maintenance to an existing runtime environment without changing the configuration
If no new members or parameters are introduced by the maintenance that is being applied to an existing runtime environment (RTE), the only configuration job that you need to run is KCIJPLOD. The KCIJPLOD job copies the members of the products' SMP/E target libraries to the RTE's read-only RK* runtime libraries. You can run the job in WKANSAMU, or use the PARMGEN Workflow tool. You can load RTEs individually or load all RTEs at one time.
About this task
The KCIJPLOD job loads the runtime libraries with IEBCOPY in a two-step process:
- All members are copied from the SMP/E target libraries to the runtime libraries.
- The runtime libraries are compressed.
Procedure
- Submit the KCIJPLOD job in the %RTE_PLIB_HILEV%.%RTE_NAME%.WKANSAMU library.
- Submit the KCIJPLOD job from the PARMGEN Workflow interface:
- Enter a question mark (?) in the RTE_NAME field
on the first Workflow panel. The Runtime Environments (RTEs) panel
is displayed.
KCIP@RTE ---------------- RUNTIME ENVIRONMENTS (RTEs) ------ Row 6 to 10 of 17 Command ===> Scroll ===> PAGE Locate the RTE you want to process from the list of RTEs inventoried from the PARMGEN global library (QISUN.IDTST.PARMGEN.JCL). See F1=Help for additional cross-RTE Actions/RTE Commands available. Single RTE Actions: Type the action character next to the RTE name: "S" or "/" Switch to an RTE. "P" Display the products configured in an RTE. "D" Delete an RTE. You cannot delete the active RTE. Multiple RTE Actions: Type the action character next to one or more RTEs: "L" Copy read-only (RO) elements from the SMP/E target libraries to the RO RK* runtime libraries (KCIJPLOD job). Multiple RTE Commands: Type the indicated command on the command line: "LOADALL" Submit multi-load (KCIJPLOD) job for all listed RTEs. "SHOWDESC"/"HIDEDESC" Show/Hide RTE Description for all listed RTEs. RTE Name Read-only (RO) shared libraries (SHRLIBs) Load SHRLIBs? VARS? _ DEMO N/A (TSTEST.CCAPI.DEMO.RK* FULL RTE libs) N/A (FULL RTE) N _ DEMOHA N/A (TDITN.IDTST.DEMOHA.RK* FULL RTE libs) N/A (FULL RTE) N _ DEMOMVS N/A (TSTEST.CANDLET.XEGA.DEMOMVS.RK* FULL RTE N/A (FULL RTE) N _ PGN3MVSE TSTEST.BASE2.RK* base libs Y Y _ PLBHAHUB N/A (TSTEST.&userid.PLBHAHUB.RK* FULL RTE libs) N/A (FULL RTE) N
- Type L to select the RTE or RTEs you want to load, then press Enter, or enter LOADALL to load all RTEs listed in the global JCL library.
- Enter a question mark (?) in the RTE_NAME field
on the first Workflow panel. The Runtime Environments (RTEs) panel
is displayed.
If any members in the IEBCOPY steps are not found in the source libraries, a return code of 4 (which is acceptable) is generated.
For further information, see the comments in the KCIJPLOD job if you use option 1, or KCIJ@LOD from GBL_USER_JCL if you use a LOADDATV function.