Defining the runtime environment
To define the runtime environment (RTE) you want
to configure, you 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
-
Launch PARMGEN by using the following command:
where gbl_target_hilev is the high-level qualifier for the SMP/E target libraries where the products are installed.EX 'gbl_target_hilev.TKANCUS'
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
-
Select 3 (Configuration Workflow).
If this is the first time you have invoked PARMGEN using this TSO user ID, or if the CSI target library is different from the last one accessed by the user ID, the Specify GBL_TARGET_HILEV Parameter panel is displayed:
KCIP@TLV ------------- SPECIFY GBL_TARGET_HILEV PARAM Command ===> PARMGEN stores configuration values in the TSO user's ISPF profile. If this is the first-time your TDITNT TSO user ID is invoking PARMGEN, enter the GBL_TARGET_HILEV-related values appropriate for your deployment: UNIT / STORCLAS / VOLSER MGMTCLAS GBL_TARGET_HILEV: ___________________________________ ________ / ________ / HLQ of SMP/E target (TK*) datasets ______ ________ Note: If this is not the first time your TDITNT ID is invoking PARMGEN, this panel is also presented if the GBL_TARGET_HILEV stored value changed from the last time you invoked PARMGEN. Verify GBL_TARGET_HILEV, UNIT, VOLSER, STORCLAS, and/or MGMTCLAS values accordingly. Reference: Last PARMGEN environment stored in TDITNT's ISPF profile: GBL_USER_JCL: RTE_PLIB_HILEV: RTE_NAME: Last GBL_TARGET_HILEV:
Enter the high-level qualifier for the SMP/E target data sets, and the UNIT/VOLSER and STORCLAS/MGMTCLAS if necessary. The following panel is displayed.KCIPQPGA -------- PARAMETER GENERATOR (PARMGEN) WORKFLOW MENU ----------------- Command ===> Quick Configuration Mode Enter parameter values appropriate for the LPAR runtime environment (RTE). GBL_USER_JCL: ____________________________________________ (for example, TDITNT.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: ________________________ 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: ________ (Type ? for a list of configured RTEs) Specify the runtime environment (&rte_name) for this LPAR.
- Provide the requested values to define the RTE that you
want to create.
- GBL_USER_JCL
- Specifies the data set name
of the PARMGEN global user JCL library. Enter the fully-qualified name that you want to use to store
definitions for every RTE you might create on the LPAR. If the data set does not exist, you are
prompted to correct the name or allocate the data set. For
example:TDITN.IDTST.PARMGEN.JCL.
The PARMGEN global user JCL library is also where the PARMGEN process creates the variables configuration profile.
- RTE_PLIB_HILEV
- Specifies the non-VSAM
high-level qualifier to use for the following PARMGEN work libraries. For example:
TDITN.IDTST.
- The WCONFIG control library where configuration profiles and other members are stored
- The interim staging (IK*) libraries where PARMGEN product runtime members (template versions) are stored
- The work output (WK*) libraries where PARMGEN file-tailored runtime members and jobs are created
- RTE_NAME
- Specifies a unique name for the
RTE you are creating. The name is appended to the RTE_PLIB_HILEV value to make
each set of PARMGEN and runtime libraries unique: %RTE_PLIB_HILEV%.%RTE_NAME%.WCONFIG(%RTE_NAME%).
Tip: You might want to use the name of the LPAR and some distinguishing element in case more RTEs are created for LPAR. For example: SYSA.
- Press Enter to proceed to the primary options menu.
The following message is displayed:
KCIP@MSG -------------------- PARMGEN MESSAGES ----------------------------- Command ===> You have asked to configure a new RTE profile. Proceed to configure a new RTE profile. Press ENTER to continue. Press F3 to abort.
- Press Enter.
The PARAMETER GENERATOR (PARMGEN) Workflow - Primary Option Menu (KCIPQPGB) for Quick Configuration mode 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