Completing the setup of the runtime environment

To complete the setup of the runtime environment using the Parameter Generator configuration software, you submit the batch jobs created by the $PARSE job in the previous step. These jobs allocate the runtime libraries, copy members from the target libraries to the runtime libraries, run required security jobs, and the like, using the values you supplied during the configuration process. You will have to complete additional tasks outside of the configuration software.

1. From the Quick Configuration Workflow - Primary Option Menu, select Submit batch jobs to complete PARMGEN setup.

   KCIPQPGB  PARAMETER GENERATOR (PARMGEN) WORKFLOW - PRIMARY OPTION MENU --------
   Option ===>                                                                    
                           Quick Configuration Mode                               
                                                                                  
   GBL_USER_JCL:   TDITN.IDTST.PARMGEN.JCL                                       
   RTE_PLIB_HILEV: TDITN.IDTST                                                   
   RTE_NAME:       SYSA                                                         
                                                                                  
   Notes: Perform steps 1 through 5 in sequence, repeating steps as necessary.    
          If reconfiguring this RTE, see Maintenance Scenarios F1=Help topic.     
          Enter n (1-5) to perform tasks.                                         
          Enter ns (1s-5s) for detailed job/task status.                          
                                                                                  
                       Description                  Job/Label  Status      Date   
       -------------------------------------------- --------- --------- ----------
                                                                                  
   1.  Set up/Refresh PARMGEN work environment.      KCIJPCFG  
   2.  Customize PARMGEN configuration profiles.     SYSA                       
   3.  Create this RTE's runtime members and jobs.   $PARSE   Enter 3 for details.
   4.  Submit batch jobs to complete PARMGEN setup.  SUBMIT   Enter 4 for details.
   5.  Perform post configuration steps.             POSTCFG   
   R   Create next RTE - Reset fields.               New RTE                      
                                                                                  
   Press F1=Help for more information.  Type U or UTIL to access utility menu.    
   

   The Submit Batch Jobs To Complete PARMGEN Setup panel (KCIP@SUB) 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.

   The jobs that you need to submit to set up this RTE are indicated by a Yes in the REQ column.
2. Choose one of the following approaches.
   • To submit the full set of actions within a single job, choose option 1.
   • To submit each action individually in turn, choose options 2 through 12, as required.
   Note that some options, such as z/OS® UNIX System Services system setup, may require specific user authorization to make changes to the file system. Because the user who has been configuring the RTE may not have the correct authorization in place, specific jobs can be excluded from the composite job and submitted separately by a user who does have the correct authorization.

   If you decide to submit all the jobs automatically, submit the composite KCIJPSUB job. Otherwise, submit the jobs individually.

   KCIJPALO

   This required job allocates the RK* runtime libraries for all the products and components in the runtime environment.

   KCIJPLOD

   This required job copies members of the target libraries that were installed by SMP/E to the read-only RK* libraries.

   The job also deletes any runtime members from the different libraries based on the product versions' FMID requirements if, for example, the latest version of the product removes or renames any SMP/E elements. If any of the libraries listed in the DELRUN DDNAME is part of the system link libraries, or the library may be in use, the KCIJcLOD RTE load job may not be able to delete these elements if the libraries are enqueued. If either of these situations is true, run the BUILDEX/DELRUN step when those libraries are available.

   KCIJPSEC

   This job is required if the product-specific IBM®-supplied security exit or input must be customized. The job creates security-related members (load modules, encryption key, and other elements) based on the product security requirements.

   Review the KppSUPDI Modify Classic command table security steps. The KppJPSCO input members to the composite KCIJPSEC security job point SYSIN DD to your security exit library (RTE_X_SECURITY_EXIT LIB). Also see the RTE_X_SECURITY_EXIT_LIB parameter in the RTE profile.

   KCIJPUSP

   This job is required if you are configuring at least one product that requires z/OS UNIX. The job creates the z/OS UNIX-related members in the RKANDATV runtime library for use in the composite KCIJPUSS job.

   Tip: This job is required if you enabled the self-describing agent feature.

   KCIJPUSS

   This job is required if you are configuring at least one product that requires z/OS UNIX. The job creates the Hierarchical File System (HFS) or the zSeries File System (zFS) directories and subdirectories, and copies files to HFS or zFS.

   Tip: This job is required if you enabled the self-describing agent feature.

   KCIJPSYS

   This job copies the product started tasks, VTAM major node members, and health check elements for the products and components into system libraries, and assembles and links product modules into system libraries. The job requires write access to system libraries.

   KCIJPLNK

   The job assembles and links elements into the SYSLMOD RKANMOD* load library.

   KCIJPUPV

   If system variables are enabled (RTE_SYSV_SYSVAR_FLAG = Y), this job must be submitted in the target LPAR where the symbolics are resolved. This job populates variable-named members contained in the application-specific KppJPUPB composite IEBUPDTE members in the WK* work output libraries. See the KCIP@SUB help panels for more information.

   KCIJPCPR

   This job clones the existing production runtime user libraries (RK*).

   KCIJPW2R/KCIJPW1R

   These jobs (Option 12) copies the WK* work output libraries to the respective production RK* runtime libraries. If you do not run this job, you must copy the work output libraries to the runtime libraries by some other method, following your normal change control process. 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. Users must add members they want saved to their RTE WCONFIG(KCI$XW2R) member.

3. On completion of these jobs, review the output of the KCIJPIVP configuration verification job:
   1. Review the $IVPRPT report.
      This report is stored in the WCONFIG library. The report shows the results of each KCIJP* job that was run to configure the runtime environment. In the following example, the report shows that the KCIJPLOD job had an ABEND E37 out-of-space condition in one or more of the libraries loaded by the job:

      JOB      STATUS  JOBNAME   JOB#   DATE   TIME    HI-CC
      -------- ------- -------- ------ ------ -------- -----
      KCIJPCFG OK      CCAPI$JP  J29242 10.056 22:46:42 00000
      KCIJPUP1 OK      CCAPI$JP  J29243 10.056 22:48:09 00000
      KCIJPCNV OK      CCAPI$JP  J28705 10.056 13:33:21 00000
      $PARSE   OK      CCAPI$JP  J29248 10.057 00:33:44 00000
      KCIJPUP2 OK      CCAPI$JP  J06969 10.057 03:21:59 00000
      KCIJPALO WARNING CCAPI$JP  J07021 10.057 03:46:46 00002
      KCIJPLOD ERROR   CCAPI$JP  J06973 10.057 03:26:14 SE37

   2. Review the WSUPERC SYSTSPRT report, which is stored in the WSUPERC sequential library.
      This report compares the PARMGEN WK* work output libraries with the production RK* runtime libraries. The PARMGEN WK* work output libraries are the data sets created and populated by the $PARSE job.
      In the following example, two files in the new WKANCMDU data set do not have equivalents in the existing RKANCMDU data set:

      48 TOTAL MEMBER(S) PROCESSED AS A PDS
      1 TOTAL MEMBER(S) PROCESSED HAD CHANGES
      47 TOTAL MEMBER(S) PROCESSED HAD NO CHANGES
      2 TOTAL NEW FILE MEMBER(S) NOT PAIRED
      0 TOTAL OLD FILE MEMBER(S) NOT PAIRED
      1 ISRSUPC - MVS/PDF FILE/LINE/WORD/BYTE/SFOR COMPARE UTILITY- ISPF
      NEW: &rhilev.&rte.WKANCMDU	 OLD: &rhilev.&rte..RKANCMDU
                               MEMBER SUMMARY LISTING (LINE COMPARE) 
      NON-PAIRED NEW FILE MEMBERS | NON-PAIRED OLD FILE MEMBERS 
           KC2OPS01               | 
           KC2STA01               |

   3. Correct any errors and rerun any jobs that did not complete successfully. Resubmit the KCIJPIVP job whenever the work output libraries change (for example, after applying maintenance and rerunning the $PARSE or $PARSEV job). You can submit the job by typing UTIL on the command line of any Workflow panel, then selecting Validate PARMGEN profile parameters.