Specify the runtime environment

To specify the runtime environment (RTE) you want to configure, specify the name of the RTE, identify the library where the JCL for all the RTEs that share the same global properties is stored, and provide the high-level qualifier that together with the RTE name uniquely identifies the data sets for this RTE.

Procedure

  1. Launch PARMGEN by using the following command:
    EX  'gbl_target_hilev.TKANCUS'
    where gbl_target_hilev is the high-level qualifier for the SMP/E target libraries where the products are installed.
    The Welcome screen for the z/OS Installation and Configuration Tools is displayed:
    KCIPQPGW                                                                  
            Welcome to the z/OS Installation and Configuration Tools for      
                           z Systems Management Suites                        
                                                                              
    Option ===>                                                               
                                                                              
    1. Checklist: System preparation checklists                               
       Tip: Read/Print Checklists prior to installation and configuration.    
                                                                              
    2. Installation Workflow:                                                 
       SMP/E-install z/OS products with Install Job Generator (JOBGEN)        
       Conditional: JOBGEN is not required when using SystemPac or ServerPac. 
                                                                              
    3. Configuration Workflow (Post-installation):                            
       Configure z/OS products with Parameter Generator Workflow (PARMGEN)    
                                                                              
    I. What's New in PARMGEN?                                                 
                                                                              
                                                                              
                                                                              
    Maintenance Level: HKCI310 PTF UA94193 (APAR OA53974 4Q17 Interim Feature)
                         ©Copyright IBM Corporation 1992-2017                 
                     Licensed Material - Program Property of IBM              
     
  2. Select option 3 and press Enter to enter PARMGEN.
  3. Provide the requested values to locate the RTE where you want to add the OMEGAMON for JVM agent.
    GBL_USER_JCL
    Specify the data set name of the PARMGEN global user JCL library for the existing RTE. For example:TDITN.IDTST.PARMGEN.JCL.
    RTE_PLIB_HILEV
    Specify the non-VSAM high-level qualifier of the existing RTE for the PARMGEN work libraries. For example: TDITN.IDTST.
    RTE_NAME
    Specify the name for the existing RTE you created before, for example: SYSA.
     KCIPQPGA -------- PARAMETER GENERATOR (PARMGEN) WORKFLOW MENU -----------------
     Command ===>                                                                   
                             Quick Configuration Mode                               
                                                                                    
     Enter parameter values appropriate for the LPAR runtime environment (RTE).     
                                                                                    
     GBL_USER_JCL:   TDITN.IDTST.PARMGEN.JCL_____________________                   
                     (for example, TDITNT.DEV.ITM63055.SYSPLEX.PARMGEN.JCL)         
                     Specify the dataset name of the PARMGEN common/global          
                     library for the different LPAR runtime environments (RTEs).    
                     Use the same dataset for managing the different LPAR RTEs.     
                     Multiple users can specify the same dataset to manage RTEs.    
                                                                                    
     RTE_PLIB_HILEV: TDITN.IDTST_____________                                       
                     Specify the High-Level Qualifier (&hlq)   portion of the       
                     PARMGEN interim staging and work libraries for this LPAR RTE:  
                     - &hlq.&rte_name.IK* (IKANCMDU,IKANPARU,IKANSAMU)              
                     - &hlq.&rte_name.WK* (WKANCMDU,WKANPARU,WKANSAMU)              
                     - &hlq.&rte_name.WCONFIG                                       
                                                                                    
     RTE_NAME:       SYSA____  (Type ? for a list of configured RTEs)               
                     Specify the runtime environment (&rte_name)   for this LPAR.   
     Press F1=Help for more information.  Type U or UTIL to access utility menu.    
                                                                                    
  4. Press Enter.

    The PARAMETER GENERATOR (PARMGEN) Workflow - Primary Option Menu (KCIPQPGB) is displayed.

     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                                                           
                                                                                    
     Note: 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   
     4.  Submit batch jobs to complete PARMGEN setup.  SUBMIT   
     5.  Perform post configuration steps.             POSTCFG                      
     R   Create next RTE - Reset fields.               New RTE