How to: Change SMP/E target libraries

If you want to install maintenance or upgrades while leaving your current CSI to support your production environment, install the new software into a new CSI and then change the SMP/E target libraries to upgrade the runtime environments (RTEs). This topic explains how to perform this task using PARMGEN.

1. Change the target libraries and refresh the work environment.
   1. In the Workflow - Primary Option panel, select Set up PARMGEN work environment for an RTE.
      A message reminds you that if you make any changes to the parameters on the following panels, you will have to rerun the KCIJPCFG job.
   2. Press Enter to proceed to the first set up panel, then press Enter again to display the second set up panel.
      This panel contains the high-level qualifier for the current SMP/E libraries.

      
       KCIP@PG2  SET UP/REFRESH PARMGEN WORK ENVIRONMENT FOR AN RTE (2 OF 3) ---------
      Command ===>                                                                   
                              Quick Configuration Mode                               
      GBL_USER_JCL:   TDITN.IDTST.PARMGEN.JCL                                       
      RTE_PLIB_HILEV: TDITM.IDTST                                                   
      RTE_NAME:       SYSA                                                         
                                                                                     
      Enter parameter values appropriate for your environment:                       
                                                             UNIT     / STORCLAS /   
                                                             VOLSER     MGMTCLAS     
      GBL_TARGET_HILEV: IBM.TARGET.ITM63055________________  ________ / ________ /   
                        HLQ of SMP/E target (TK*) datasets   ______     ________     
                                                                                     
      GBL_SYSDA_UNIT:   SYSDA___                                                     
                        Work datasets UNIT name                                      
                                                                                     
      GBL_REGION:       0M______                                                     
                        JCL REGION (specify K/M suffix)                              
      
                                                                                     
      Note: Type BACK to go back one panel.  Type UTIL to access utility menu.       

   3. Change the high-level qualifier (GBL_TARGET_HILEV) to the high-level qualifier for the new libraries, then press Enter.
   4. Press Enter again on the third set up panel to retain the same parameter values.
   5. On the Include Products in this PARMGEN RTE panel, set Confirm ==> to Y to accept the current product set, then press Enter.
      Note that if this RTE includes only a high-availability hub, the Include Products panel is not displayed. If new versions of products are included in the target libraries, the products configured in the RTE will be upgrade to those versions.

      A message asks you to provide a backup name for the RTE configuration profile.

   6. Provide the requested name, then press Enter.
      The KCIJPCFG JCL is displayed.
   7. Submit the job.
      The KCIJPCFG job submits the KCIJPPRF job, which updates the libraries and merges the backed up profile with the newly generated one that contains any new parameters introduced by maintenance or upgrades.
   8. Return to the Workflow primary options menu. Wait until both jobs have completed before proceeding to the next step. No return code is displayed on the Workflow main panel until both jobs have completed.
2. Recreate the runtime members and jobs.
   1. From the primary options menu, select Create the RTE members and jobs.
   2. On the Create the RTE Members and Jobs panel (KCIP@PR1), select option 1 to submit the $PARSE job (or $PARSESV job if variables are enabled).
      The $PARSE JCL is displayed.
   3. Submit the job and return to the Workflow - Primary Options Menu. Wait until the job completes, then proceed to the next step.
3. Submit the LOAD job and any other jobs required by affected products or components.
   1. From the primary options menu, select Submit batch jobs to complete PARMGEN setup.
      The Submit Batch Jobs to Complete PARMGEN Setup panel (KCIP@SUB) is displayed.
   2. Submit the following jobs and any other jobs indicated by a Yes in the REQ column or by the HOLD++ data for each product or component.
      • KCIJPLOD: This required job copies members of the target libraries that were installed by SMP/E to the read-only RK* libraries.
      • KCIJPW2R: This job deploys the updated runtime members from the WK* work libraries to the RK* production user libraries.

      If you run KCIJPW2R, run KCIJPCPR to back up the RK* production libraries.

      You might have 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)
      • KCIJPUSP and KCIJPUSS (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)