PARMGEN PTF UA81228 for APAR OA49893 (2Q16 Interim Feature)

PARMGEN PTF UA81228 for APAR OA49893 (2Q16 Interim Feature) introduces several enhancements affecting all products that use the configuration software.

The configuration software includes the following enhancements:

Enhanced the $PARSE composite batch job run elapsed time-to-value savings. $PARSE jobs have better performance.
Enhanced the following help topics in Welcome to the z/OS Installation and Configuration Tools for z Systems Management Suites panel (KCIPQPGW panel / KCIHPGW help panel):
- IBM z Systems Management Suites that PARMGEN helps deploy - Overview
- Components in the Product Suites Matrix by Suite Code
- Components in the Product Suites Matrix by JOBGEN Exploitation
- Components in the Product Suites Matrix by PARMGEN Exploitation
You can have a smoother deployment of the products suites with better planning, system preparation, installation, configuration and post-configuration.
Provided currency support:
- Updated PARMGEN SYSCPUS pop-up panel that displays informational message about the number of CPU(s) and system hardware on the LPAR that PARMGEN is running on. Added support for new z13s (CPC Type=2965 Hardware=IBM z13s).
- Updated the PARMGEN job KCIJPALO “Allocate runtime read-only (RO) and read-write (RW) user datasets” to accommodate PDSE V1 requirement when the RTE is enabled for PDSE support (RTE_SMS_PDSE_FLAG=Y). PDSE V2 format requires DFP FMID HZD2vvv PTF UA81278/UA81279/UA81280 tracked in DFP APAR OA45431. For more information, see technote ABEND0F4 RKANDATV RKNSLOCL KLVPA001 KLVPA007 KLVPA002 KLVPA003.
- Updated the default value of parameter GBL_HFS_JAVA_DIR1 (for global Java bin path) from /usr/lpp/java/J6.0 to /usr/lpp/java/J7.1 for new RTE deployments.
Enhanced the RTE_USS_RTEDIR and TKANJAR DDDEF processing by providing a runtime version of the installation z/OS® UNIX System Services directory. If you have copies of the SMP/E targets on z/OS and z/OS UNIX directories, you can deploy the new maintenance to the runtime copies based on their maintenance rollout schedule.
Additional IVP advanced validation checks during PARMGEN $PARSE VALIDATE step or PARMGEN KCIJPVAL standalone validation job:
- Detect an warning if the RTE is enabled for variables to review RTE_USS_RTEDIR parameter for more information. If the RTE has variables enabled, the corresponding KDS_KMS_SDA user symbol resolution value is set to Y in the GBL_USER_JCL RTE variables profile.
- Detect an error condition when OMEGAMON XE for DB2 profile parameter KD2_DBnn_DB2_PORT_NUM port number is not unique per DB2 subsystem.
- Detect an error condition when required KI2_I1nn_CLASSIC_IMS_RESLIB profile table parameter is not supplied for configuring OMEGAMON XE for IMS product.

Enhanced %GBL_USER_JCL%(%RTE_NAME%) LPAR RTE variables and %GBL_USER_JCL%(KCI$RTEV) LPAR RTE IBM default variables profile to provide best-practice user symbols used in the WCONFIG(%RTE_NAME%) LPAR RTE profile and in the WCONFIG(Kpp$*) override imbeds. Provide tailored or predefined model user symbols for quicker deployment of operational changes.

From %GBL_USER_JCL%(KCI$RTEV) IBM default variables profile and %GBL_USER_JCL%(%RTE_NAME%) LPAR RTE user variables profile:

- KDS_USERS_NO_MSGLOG "SRVR01,sysadmin,KOB101,Kpp" *example usage syntax
- KOE_ALLOW_ANY_UID        1           *default if used 
- KOE_ALLOW_UNDEFINED        1         *default if used 
- KM5_KM5ZIIPOFFLOAD         NO        *if parameter is enabled
- KM5_RMF_DDS             "NO"         *default if used     
- *KM5_RMF_DDS "%KM5_RMF_DDS_COLLECTION%"           *Your WCONFIG

From WCONFIG(KDS$PENV) TEMS KDSENV imbed:

KDS_USERS_NO_MSGLOG "SRVR01,sysadmin”
*KDS_USERS_NO_MSGLOG=&KDS_USERS_NO_MSGLOG. 
*KOE_ALLOW_ANY_UID=1                             
*KOE_ALLOW_ANY_UID=&KOE_ALLOW_ANY_UID.           
*KOE_ALLOW_UNDEFINED=1                           
*KOE_ALLOW_UNDEFINED=&KOE_ALLOW_UNDEFINED.       
*KM5ZIIPOFFLOAD=NO                               
*KM5ZIIPOFFLOAD=&KM5_KM5ZIIPOFFLOAD.

Provided default placeholder parameter support in various WCONFIG(Kpp$PENV) imbeds to the xKANPARU(KppENV) environment runtime members.
- KDS_USERS_NO_MSGLOG=SRVR01,sysadmin in TEMS KDS$PENV
- *KDS_USERS_NO_MSGLOG=&KDS_USERS_NO_MSGLOG. in TEMS KDS$PENV
- *KOE_ALLOW_ANY_UID=1 in TEMS KDS$PENV
- *KOE_ALLOW_ANY_UID=&KOE_ALLOW_ANY_UID. in TEMS KDS$PENV
- *KOE_ALLOW_UNDEFINED=1 in TEMS KDS$PENV
- *KOE_ALLOW_UNDEFINED=&KOE_ALLOW_UNDEFINED. in TEMS KDS$PENV
- *KM5ZIIPOFFLOAD=NO in TEMS KDS$PENV
- *KM5ZIIPOFFLOAD=&KM5_KM5ZIIPOFFLOAD. in TEMS KDS$PENV

Provided new &gbl_target_hilev.TKANSAM(*MDL*) predefined RTE models to quickly deploy other types of RTEs and product combination.

Table 1. New predefined RTE models
Scenario	Template name	RTE type	Monitoring server type	System variables	Description
QCF21	$MDLHSBV	Sharing-with-base	Hub	Yes	Predefined RTE models include a z/OS Tivoli Enterprise Monitoring Server (TEMS, whether this is a Hub TEMS or a Remote TEMS), an OMEGAMON enhanced 3270 user interface (TOM) and both types of z/OS monitoring Agents (Agents that run in the z/OS TEMS address space and Agents that run in their own standalone Agent address spaces).
QCF22	@MDLHSSV	Sharing-with-SMP/E	Hub	Yes	Predefined RTE models include a z/OS Tivoli Enterprise Monitoring Server (TEMS, whether this is a Hub TEMS or a Remote TEMS), an OMEGAMON enhanced 3270 user interface (TOM) and both types of z/OS monitoring Agents (Agents that run in the z/OS TEMS address space and Agents that run in their own standalone Agent address spaces).

Enhanced “Set up/Refresh PARMGEN work environment” KCIJPCFG processing for brand new user of PARMGEN in a new LPAR by including the user’s accounting information (ZACCTNUM) in the IBM-supplied jobcard.
Enhanced “Set up/Refresh PARMGEN work environment” KCIJPCFG processing discussed in the SMP/E maintenance and upgrade scenarios by automatically defaulting a backup RTE profile member name on the “KCIP@BAK IMPORTANT - REFRESH THE LPAR RTE USER AND IBM PROFILES” panel. The KCIJPPRF profile refresh job is submitted automatically by the KCIJPCFG job to simplify the following processes:
- The refreshing of product templates in IK* datasets.
- The rebuilding of the LPAR RTE and global profiles (IBM-supplied) with the new values.
- The merging of the customized profile values from the backed-up LPAR RTE user profile into the refreshed WCONFIG RTE profile.
- The generating of a delta report.
Enhanced panel and on-line help panel updates to aid in deployment.
- Enhanced the main PARMGEN “Welcome to the z/OS Installation and Configuration Tools for z Systems Management Suites” by streamlining the configuration workflow option to display a streamlined “Configuration Workflow (Post-installation): Configure z/OS products with Parameter Generator Workflow (PARMGEN)” selection only, rather than providing recommended Quick Configuration mode and the alternate Standard Configuration mode.
- Enhanced the “R” option on the “KCIPQPGB PARAMETER GENERATOR (PARMGEN) WORKFLOW - PRIMARY OPTION MENU” panel by clarifying the option name as “R Create next RTE - Reset fields” and navigating the user automatically to the “KCIPQPGA PARAMETER GENERATOR (PARMGEN) WORKFLOW MENU” panel to supply the RTE name of the next RTE to create or clone from an existing RTE.
- Added profile parameter on-line help text in F1=HELP for the following parameters:
  - Global profile parameters in WCONFIG($GBL*) prefixed by GBL_.
  - Common LPAR profile parameters in WCONFIG(%RTE_NAME%) prefixed by RTE_.
  - TEMS profile parameters in WCONFIG(%RTE_NAME%) prefixed by KDS_X_.
  - Common Agent profile parameters in WCONFIG(%RTE_NAME%) prefixed by Kpp_X_.
- Enhanced the “F16=CLNESECT CLONE SECTION” KCIP@PM2 panel to provide better examples and a complete list of Kpp product table profile parameters that can be cloned.
- Enhanced the “IMPORTANT - REFRESH THE LPAR RTE USER AND IBM PROFILES” KCIP@BAK panel to provide a default backup LPAR RTE profile name to the “%RTE_NAME% Backup member name” field.
- Updated existing help topics focusing on additional system preparation requirements for products that have z/OS UNIX SMP/E and configuration deployment requirements when SDA is enabled, and for products that update their TKANJAR DD jar files.
- Added help topics focusing on PARMGEN utilities such as PF Keys and macros.
- Added help topics focusing on PARMGEN Transport scenarios.