How to: Merge predefined variables into configuration profiles

Using variables makes it much easier to change operational values, such as storage-related values or port numbers, that affect multiple products and runtime environments. You can change the resolution values of the variables without recreating the runtime environments. IBM provides a set of system variables and user-defined variables that you can import into your configuration profiles. The variable symbols automatically replace the values for the corresponding parameters so you do not have to edit the parameters individually.

Before you begin

If your RTE needs to be updated in any way (for example, to apply the latest maintenance), reconfigure the RTE before you merge the model variables into your profile (KCIJPCFG). Follow the appropriate SMP/E scenario for applying the maintenance.

About this task

The KCIJPMCF job sets the variables support flag if necessary and merges the set of variables in the %GBL_TARGET_HILEV%.TKANSAM($MDLVARS) member into the current RTE configuration profile. The merge replaces current configuration values with symbolics. These symbolics are predefined with IBM defaults. You need to import these definitions from %GBL_USER_JCL%(KCI$RTEV) into your variables profile.

The merge job does not overlay values like high-level qualifiers, started task prefixes and names, and VTAM applid prefix and names that are inherited from the KCIP@PG3 panel. After you run the merge job, review these parameters in the RTE configuration profile to decide whether you to change them to variables such as &SYSNAME, or &SYSCLONE..

This procedure consists of six steps:

  1. Merge the model variables into the configuration profiles.
  2. Edit the RTE configuration profile.
  3. Copy the KCI$RTEV member into the variables profile and edit the profile.
  4. Recreate members and jobs ($PARSESV).
  5. Submit the jobs necessary to complete the set up of the RTE.
  6. Recycle any affected started tasks.

Procedure

  1. Merge the model variables.
    1. Enter UTIL on the command line of a Workflow panel.
      The Utilities panel is displayed.
    2. Select Merge profile from a backup LPAR RTE profile (option 16).
      The JCL for the KCIJPMCF job is displayed.
    3. Edit the value for OLDMEM to point to %GBL_TARGET_HILEV%.TKANSAM($MDLVARS). 
       000079 //* Merge the changes in %OLDMEM% into %NEWMEM% member.                 
 000080 //* ******************************************************************* 
 000081 //MERGECHG  EXEC  PGM=IKJEFT01,DYNAMNBR=99,REGION=4M                    
 000082 //SYSEXEC   DD DISP=SHR,                                                
 000083 //          DSN=TDITNT.DEV.ITM63053.TKANCUS                             
 000084 //SYSTSPRT  DD SYSOUT=*                                                 
 000085 //SYSPRINT  DD SYSOUT=*                                                 
 000086 //SYSTSIN   DD *                                                        
 000087   KCIRPLBX +                                                            
 000088   BATCH +                                                               
 000089   SKIPVAR(TDITNT.DEV.ITM63053.TKANCUS(KCIDPGNX)) +                      
 000090   OLDMEM(%GBL_TARGET_HILEV%.TKANSAM($MDLVARS)) +                  
 000091   NEWMEM(TDITN.FTU.$MDLHFV.WCONFIG($MDLHFV))
    4. Submit the job.
  2. Edit the RTE configuration profile.
    1. From the Workflow main menu, select Customize PARMGEN configuration profiles.
      The Customize PARMGEN Configuration Profile Members panel is displayed.
    2. Enter 1 to edit the RTE configuration profile.
    3. Edit the profile to implement variables for any of the inherited parameter values that were not overwritten.

      For example, RTE_NAME is inherited as part of multiple parameters, such as RTE_TEMS_NAME_NODEID, RTE_X_SECURITY_EXIT_LIB, or RTE_PDS_HILEV. Change the static RTE name in the parameter values to &SYSNAME. by doing XF on the RTE name, and then doing a change all to &SYSNAME..

    4. Change the value of RTE_NAMESV back to the static RTE name.
    5. Save your changes and return to the Customize PARMGEN Configuration Profile Members panel.
  3. Copy the KCI$RTEV member into the variables profile and edit the profile.
    1. Select option 3 (Customize the Variables Profile).
    2. To customize the variables profile, copy the contents of %GBL_USER_JCL%(KCI$RTEV) and append them to the end of the RTE variables profile.
    3. Customize the resolution values as necessary for your site.
      Edit the values for any system variables that cannot be determined from the IPL PARMLIB and the values for any user-defined variables whose site-specific values differ from the IBM supplied defaults.
  4. Recreate members and jobs.
    1. From the Workflow main menu, select Create RTE members and jobs.
    2. Submit the $PARSESV job.
  5. Submit the jobs necessary to complete the set up of the RTE.
    1. From the Workflow main menu, select Submit batch jobs to complete PARMGEN setup .
      The Submit Batch Jobs to Complete PARMGEN Setup is displayed.
    2. Submit the KCIJPSYS job to refresh started tasks or manually refresh the started tasks in the PROCLIB.
      If the RTE was previously enabled for variables, and you did not make any changes to previously defined RTE parameters with symbols, you do not need to submit the KCIJPSYS job. Instead, you can just edit the RKLVIN DDNAME as follows:
      
//RKLVIN   DD DISP=(OLD,PASS),          
//         DSN=&&TMPPARU(&STARTUP),      
//         VOL=REF=*.KCIPARSE.TMPPARU,   
//*RKLVIN   DD DISP=SHR,                 
//*         DSN=&USERPARU(&STARTUP),     
//         FREE=CLOSE
    3. Submit the KCIJPW2R job to deploy the updated runtime members from the WK* libraries to the RK* production user libraries.
  6. Recycle the affected started tasks.