Completing the setup of the runtime environment

Edit online

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.

Procedure

From the 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.

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 and VTAM major node members 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.
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.

Results

The runtime environment DEMO is created.

What to do next

Complete any configuration required outside of the configuration software. To see the required steps, return to the Workflow - Primary Option Menu and select Perform post configuration steps. This option displays a set of readme files that describe the additional configuration steps that must be taken for the components and products that are configured in this RTE. For additional information, see Completing the configuration outside the configuration software and the Planning and Configuration Guide for each of the configured products.