Customizing the variables profile

If support for variables is enabled and you are using user-defined variables, you must customize the variables profile, %GBL_USER_JCL%(%RTE_NAME%), to define those variables and their resolution values. If you are using IBM-provided models for RTEs that support variables, you must customize the resolution values for any symbolics used in the model if those values differ from the IBM defaults.

About this task

The variables profile must be customized under the following conditions:
  • For Type 1 and 2 symbolics, if you are using any of the IBM-provided predefined symbolics, and the resolution values for those symbolics cannot be automatically discovered in IEASYM or the system IPL PARMLIB data sets, you must provide those resolution values.
  • For any Type 3 symbolics, you must provide both the symbolics and the resolutions values. You can use the IBM-provided "best practice" user symbolics, but you must provide the site specific resolution values for those symbolics.
  • If you are not configuring the RTE on the target system, and there are resolution values that cannot be automatically discovered on the target system, you must provide those values, such as overrides for &SYSNAME. or &SYSCLONE..
Regardless of the type of symbolic, any symbolics that appear in started task procedures must follow MVS rules. In the RTE profile, the following parameters are the ones whose symbolic values appear in started tasks:
  • RTE_NAME
  • RTE_HILEV
  • RTE_VSAM_HILEV
  • RTE_X_HILEV_SHARING
  • RTE_SHARE
  • Kpp_*_VTAM_APPL_*
In the global profiles, the symbolics for the following parameters appear in started tasks:
  • GBL_DSN_DB2_*
  • GBL_DSN_IMS_*
  • GBL_DSN_CICS_CTG_DLL
  • GBL_DSN_WMQ_*
  • GBL_DSN_CSF_SCSFMOD0
  • GBL_DSN_TCP_SYSTCPD_TCPDATA
Tip: You can run the $PARSEDV job in WCONFIG to get a list of all the variables you can use on this system. The output report is called $SYSVAR1 and it is also found in the RTE WCONFIG data set. You can invoke the job from the Utilities panel. Enter UTIL on the command line of any Workflow panel and select option 22.
Note: Variables cannot be used with a small subset of parameters. See Parameters ineligible to use variables in the Reference section for more information.

Procedure

  1. To edit the variables profile, select option 3 on the Customize PARMGEN Configuration Profile Members panel. 
     KCIP@PG6 ------ CUSTOMIZE PARMGEN CONFIGURATION PROFILE MEMBERS ---------------
 Option ===>                                                                    
                         Quick Configuration Mode                               
  (Required) Customize the RTE profile and the $GBL$USR user profiles:       
  (Tip) Review KCIJPDLA autodiscovery job in Utility menu or type DLAJOB cmd.               
    *1. SYSA  RTE LPAR-specific CONFIG profile in WCONFIG (User copy)        
    *2. $GBL$USR Global parameters CONFIG profile in WCONFIG (User copy)        
                                                                                
  (Required)     Customize the Variables profile if RTE_SYSV_SYSVAR_FLAG=Y:     
    *3. SYSA  Variables (system, user) CONFIG profile in GBL_USER_JCL PARMGEN
                 global library (TDITN.IDTST.PARMGEN.JCL).                      
                 Add/Modify system/user-defined symbols and their               
                 resolution values, for override variables used as parameter    
                 values in the $DOCRTE RTE and $GBL$USR global profiles.        
                                                                                
  (Tip) Review/Customize WCONFIG Kpp$C*/Kpp$P*/Kpp$S* user imbeds:         
  (Cloning Tip) Review KCIJPCCF job in Utility menu prior to customization.          
     4. WCONFIG  TDITN.IDTST.$DOCRTE.WCONFIG                                    
                                                                                
  (Tip) Review if you want to compare with IBM-supplied default profile values:        
     5. $CFG$IBM RTE LPAR-specific CONFIG profile in WCONFIG (IBM copy)         
     6. $GBL$IBM Global parameters CONFIG profile in WCONFIG (IBM copy) 

  (Optional) Override SYSIN member to supply additional (User) profiles:        
     7. $SYSIN   $PARSE/$PARSESV SYSIN controls (CONFIG/SELECT MEMBER)    
                
 Press F1=Help for more information.  Type UTIL to access utility menu.
    The system variables profile is displayed.
  2. Provide values for any user-defined variables, any variables that differ from the IBM-provided defaults, and any variables whose values cannot be automatically discovered from the system IPL PARM data set.
  3. Press F3 to save the changes in the profile, then press F3 to return to the main Workflow panel.

What to do next

Customize the embed files as necessary, then create the runtime members and jobs.