Scenario SMPE03: Applying SMP/E maintenance with new configuration changes to an existing RTE and overriding the IBM-supplied configuration defaults

Typically, configuration changes introduced by Interim Features or Fix Packs are delivered as benign, and IBM-supplied configuration defaults are supplied. However, you might need to edit the configuration profiles to exploit new features or to set custom values for new parameters.

1. Refresh the work libraries.

   This step backs up (renames) the existing LPAR profile, updates the interim libraries, recreates the configuration profiles with any new parameters, and merges the backup profile with the newly created one.

   1. Select the runtime environment to which you want to apply maintenance.
   2. From the Workflow - Primary Options Menu, select Set up PARMGEN work environment for an RTE to regenerate and resubmit the KCIJPCFG job.
      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.                                                   

   3. Press Enter to continue.
      The first setup panel (KCIP@PG1) is displayed.
   4. 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.

      
      KCIP@BAK IMPORTANT - REFRESH THE LPAR RTE USER AND IBM PROFILES -------- 
       Command ===>                                                             
                                                                                
       If you changed any JVM RTE configuration values on the                 
       "SET UP/REFRESH PARMGEN WORK ENVIRONMENT" KCIJPCFG navigation          
       panels, or changed the configured product mix or upgraded product      
       versions, then you must regenerate/resubmit the KCIJPCFG/KCIJPPRF jobs.
       You must also refresh the PARMGEN profiles.                                   
                                                                                
       Specify a backup member name for the LPAR RTE to automate the          
       resubmission and refresh process.  A default backup member is provided.
       Blank-out the field if you do not want to refresh the profiles.        
                                                                                
         DEMO Backup member name   ===>  ________   (Required for KCIJPPRF)  
                                                                                
       PARMGEN automatically backs up the RTE profile in                        
       TDITN.IDTST.PARMGEN.WCONBACK, refreshes templates in IK* datasets, 
       rebuilds the profiles with the new values, merges in the profiles values
       from the backed-up LPAR RTE user profile, and generates a delta report.    
                                                                                
       Press F1 for information about the automated process.                    
      

      If you do not provide a backup name, the interim libraries are not updated and the current values cannot be merged back in.
   5. Enter a name for the profile backup member.
      The KCIJPCFG job is displayed.
   6. 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.
2. Edit profiles and override embeds to customize new features or parameters as required.
   1. Select Customize PARMGEN configuration profiles.
      The Customize PARMGEN Configuration Profile Members panel is displayed.
   2. Select the RTE, global, and variables profiles in turn as necessary and make the required customizations. If required, edit the appropriate embed members.
      Tips:

      • In a scenario where you have also added a new product to configure to this runtime environment, ensure that you also customize the new product's Kpp_* PARMGEN profile parameters that are added into the refreshed RTE configuration profile.
      • Compare the updated $CFG$IBM and $GBL$IBM to your customized profiles to determine what parameters have changed or been added.
      • Update or customize any new or modified embed files as desired.
3. Regenerate the RTE members and jobs.
   1. Select Create the RTE members and jobs.
      The $PARSE /$PARSESV: Create the RTE Members and Jobs panel is displayed.
   2. Select option 1 to submit the composite job.
      If the updates affect only one set of libraries, you can submit the library-specific job instead of the composite job. Press F5 to create runtime members and jobs in an individual library (WKANCMDU, WKANPARU, or WKANSAMU).
      The $PARSE job takes the product templates from the %RTE_PLIB_HILEV%.%RTE_NAME%. IK* staging libraries, applies the customized values from the configuration profiles, and creates the runtime members in the work libraries (WK*).
   3. Return to the main Workflow panel.
4. Submit the batch jobs necessary to complete the set up of the environment:
   1. 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.

   2. 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 run 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)