Customizing the global configuration profile

After all the settings in the RTE configuration profile have been updated, the next step is to review and customize the global parameters that will be used by this runtime environment (RTE). This step is required if you have not cloned the $GBL$USR profile from another runtime environment.

About this task

The WCONFIG($GBL$USR) member contains the parameters that define the global system libraries to be used by all components. All global parameters are prefixed GBL_. Review these parameters to determine whether the default values must be customized for this environment.
The following are the key parameters to check:
  • Common system library values
    • GBL_DSN_SYS1_PARMLIB
    • GBL_DSN_SYS1_PROCLIB
    • GBL_DSN_SYS1_SAXREXEC
    • GBL_DSN_SYS1_VTAMLIB
    • GBL_DSN_SYS1_VTAMLST
  • Health check configuration value
    This library is used to set up the health check elements, if health checks are enabled:
    GBL_DSN_HZSPROC_LOADLIB
    This parameter specifies the name of a load library that is usable by the Health Checker started task HZSPROC for assembling and linking health check modules. This library can be in the HZSPROC STEPLIB or it can be a library in LNKLIST.
  • ICSF system library
    If you are enabling password encryption (KAES256) across the enterprise, you must set the value for the ICSF system library: 
    GBL_DSN_CSF_SCSFMOD0
  • z/OS® UNIX System Services Java™ directory
    If any of the components that you are configuring within this RTE require Java support or if you are planning to enable the self-describing agent feature, a valid path to a Java installation on HFS or zFS must be specified. Note that /bin is automatically appended: 
    GBL_HFS_JAVA_DIR1
    Also, if you are enabling the self-describing agent feature or any other function that uses z/OS, check the value of the CLIST/EXEC library name. This EXEC library is used during the creation of z/OS UNIX directories running on either the Hierarchical File System (HFS) or on the zSeries File System (zFS): 
    GBL_DSN_SYS1_SBPXEXEC
If a monitoring server is using any of the IP.UDP-related or IP.PIPE-related communication protocols for connection, but the IP domain name resolution is not fully configured on the z/OS system, the SYSTCPD statement must be supported by the monitoring server and all monitoring agents that report to it. SYSTCPD explicitly identifies which data set to use to obtain the parameters defined by TCPIP.DATA when no GLOBALTCPIPDATA statement is configured. To support SYSTCPD, uncomment and set the following parameter: 
GBL_DSN_TCP_SYSTCPD_TCPDATA
The name of the SYSTCPD data set is installation-specific. Get the correct specification from your network administrator.
At a minimum, customize the following parameters for the specific products.
  • If OMEGAMON® XE for Db2® on z/OS Performance Monitor or Performance Expert is configured in the RTE:
    • Uncomment and customize the following parameters as applicable to your Db2 environment:
      • *GBL_DSN_DB2_SDSNLOAD
      • *GBL_DSN_DB2_LOADLIB_V8
      • *GBL_DSN_DB2_LOADLIB_V9
      • *GBL_DSN_DB2_LOADLIB_V10
      • *GBL_DSN_DB2_LOADLIB_V11
      • *GBL_DSN_DB2_LOADLIB_V12
      • *GBL_DSN_DB2_RUNLIB_V8
      • *GBL_DSN_DB2_RUNLIB_V9
      • *GBL_DSN_DB2_RUNLIB_V10
      • *GBL_DSN_DB2_RUNLIB_V11
      • *GBL_DSN_DB2_RUNLIB_V12
      • *GBL_DSN_DB2_DSNEXIT
  • If OMEGAMON for CICS® TG is configured, uncomment and customize the following parameter:
    • *GBL_DSN_CICS_CTG_DLL
  • If OMEGAMON for IMS on z/OS is configured, uncomment and customize the following parameter:
    • *GBL_DSN_IMS_RESLIB
  • If OMEGAMON for Messaging on z/OS is configured, uncomment and customize the following parameters:
    • *GBL_DSN_WMQ_SCSQANLE
    • *GBL_DSN_WMQ_SCSQAUTH
    • *GBL_DSN_WMQ_SCSQLOAD

Procedure

  1. To edit the $GBL$USR member, select option 2 from 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 WCONFIG($GBL$USR) member is displayed.
  2. Review and update the parameter values as appropriate.
  3. After you make all the required changes, save the changes and return to the Customize PARMGEN Configuration Profile Members panel.

What to do next

If necessary, customize the %GBL_USER_JCL%(%RTE_NAME%) variables configuration file and any necessary embed files. Then, return to the main Workflow menu and create the runtime members and jobs.