Customizing the configuration profiles

Customizing the configuration profiles is a critical part of the configuration process. The profiles contain the values that define the runtime environment, communication protocols and addresses, the framework features that are enabled, product-specific values, and so forth. The configuration profiles are tailored with the information you specify when you set up the RTE work environment. Default values are provided for all other required parameters and some optional ones. The amount of editing required to customize the configuration profiles depends upon how you are creating the runtime environment (RTE) and how much your environment differs from the model or product-provided defaults.

About this task

If you do not want to customize these parameters, and you do not want to enable optional features, you can complete the configuration by accepting these defaults. Alternatively, you can edit the profiles to override defaults and provide custom values for optional parameters that have no defaults.
  • Review and customization of the RTE configuration profile is required to override defaults with any required site-specific values, such as port numbers and to enable optional features such as automatic APF authorization, event forwarding, or support for self-describing agents.
  • Review of the $GBL$USR profiles is required under either of the following conditions:
    • If the RTE is being upgraded and there may be new GBL_* parameters introduced in the new version of the product.
    • To customize product-specific GBL_* common or global parameters that may apply to more than one product or apply to several components within a product family (for example, GBL_DB2_KD2_CLASSIC_STC parameter applies to all OMEGAMON XE for Db2 PE/PM components if configuring this product family).
  • Customization of the variables configuration file is required if the runtime environment is enabled for system variables (RTE_SYSV_SYSVAR_FLAG=Y) and user-defined symbols are being used. Any system variables whose resolution values cannot be determined from the IPL PARMLIB must also be defined.
Usage note: Include parameter values in quotation marks ("") if they include mixed casing, embedded blanks, or special characters, or if they are followed by a comment.

For help with the parameter values, consult the following resources:

  • Comments in the profiles
  • Online help for parameters (F1 )
  • Common parameters
  • The Parameter Reference for each product

Procedure

  1. To customize the configuration profiles, select option 2 from the Workflow - Primary Option Menu. 
     --------- PARAMETER GENERATOR (PARMGEN) WORKFLOW - PRIMARY OPTION MENU --------
 Option ===> 2                                                 Scroll ===> PAGE 
                         Quick Configuration Mode                               
                                                                                
 GBL_USER_JCL:   TDITN.IDTST.PARMGEN.JCL                                        
 RTE_PLIB_HILEV: TSTEST.&userid                                                 
 RTE_NAME:       DEMO                                                           
                                                                                
 Note: Perform steps 1 through 5 in sequence, repeating steps as necessary,     
       until the status of each step is RC=0. Enter n (1-5) to perform tasks.   
       Enter ns (1s-5s) for detailed job/task status.                           
                                                                                
                     Description                  Job/Label  Status      Date   
     -------------------------------------------- --------- --------- ----------
                                                                                
 1>  Set up PARMGEN work environment for an RTE.   KCIJPCFG RC= 00000 2014/03/08
 2.  Customize PARMGEN configuration profiles.     DEMO                         
 3.  Create the RTE 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   Reset RTE, Status and Date fields. (Optional) New RTE                      
                                                                                
 Press F1=Help for more information.  Type UTIL to access utility menu.
    The Customize PARMGEN Configuration Profile Members panel is displayed.
     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.
  2. To customize the profiles, select each configuration profile as required.

What to do next

If you need to include further customize the configuration using the override embed files, customize the embed files before you run the $PARSE job to create the RTE members and jobs. To edit the embed files, select option 4 on the Customize PARMGEN Configuration Profile Members panel. You can also edit the files by entering UTIL on the command line of any Workflow panel to access the Access PARMGEN Utilities panel, then selecting option 7. For more information on customizing embed files, see Customizing the override embed members.