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

Run the KCIJPLOD job using one of the following methods:

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.

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.

Results

The runtime environment is updated with the maintenance. The runtime members in the production user libraries (RKANCMDU, RKANPARU, RKANSAMU, RKD2PAR**, RKD2PRF**, RKD2SAM**) are running with the original runtime members without any new parameters or members possibly introduced with the maintenance. For example, without any new parameters in RKANPARU(KppENV), or without new members that would typically be populated in the RK* user library. Similar processing is done for the PARMGEN WK* work libraries.