PARMGEN PTF UA83283 for APAR OA51503 (4Q16B Interim Feature)

PARMGEN PTF UA83283 for APAR OA51503 (4Q16B Interim Feature) introduces several enhancements that benefit IBM OMEGAMON for JVM on z/OS.

PARMGEN configuration framework enhancements and updates

The configuration software includes the following enhancements:
  • Updated the Suites Code legend in the detailed discussion on system preparation topics such as IBM Management Suites that JOBGEN/PARMGEN help deploy – Overview, Components in the Product Suites Matrix by Suite Code, Components in the Product Suites Matrix by JOBGEN Exploitation, and Components in the Product Suites Matrix by PARMGEN Exploitation. You can find the topics on the Welcome to the z/OS Installation and Configuration Tools for IBM Tivoli Management Services (TMS) dependent products (KCIPQPGW panel / KCIHPGW help panel).
    Additional JOBGEN and PARMGEN on-line help updates are added to support the new version of the following suites:
    • New version of IBM Service Management Suite for z/OS V1.4.1. Suite is refreshed to include new versions of the following products:
      • IBM OMEGAMON for DB2 Performance Experts on z/OS V5.4.0
      • IBM OMEGAMON for JVM on z/OS V5.4.0
      • IBM OMEGAMON for Storage on z/OS V5.4.0
    • New version of IBM OMEGAMON Performance Management Suite for z/OS V5.4.1. Suite is refreshed to include new versions of the following products:
      • IBM OMEGAMON for DB2 Performance Experts on z/OS V5.4.0
      • IBM OMEGAMON for JVM on z/OS V5.4.0
      • IBM OMEGAMON for Storage on z/OS V5.4.0
    • New version of IBM Advanced Storage Management Suite for z/OS V2.2.1. Suite is refreshed to include new versions of the following products:
      • IBM OMEGAMON for Storage on z/OS V5.4.0
      • IBM Advanced Audit for DFSMShsm Agent V2.6.0
      • IBM Advanced Reporting and Management for DFSMShsm Agent V2.6.0
      • IBM Advanced Archive for DFSMShsm V1.1.0
      • IBM Cloud Tape Connector for z/OS V1.1.0
  • Updated the PARMGEN KCIJPALO job to accommodate PDSE V1 requirement for additional TMS: Engine datasets (UKANDATV/RKANDATV) 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.
  • Enhanced the PARMGEN KCIJPUSS job to change the OMEGAMON for JVM-related KCIJARPX step handling the new IBM Java Health Center Agent hca_31.pax and hca_64.pax files packaged with OMEGAMON for JVM V5.4.0 to dynamically switch to UID(0) if the TSO user ID submitting the KCIJPUSS job only has read access to the RACF class=facitity / profile=bpx.superuser.
  • Added new user symbols in the predefined RTE models: 
    - RTE_KCN_CACHE_KM5_RMF_DDS    "&KM5_NTH_DDS."
    Added new user symbol in the %GBL_USER_JCL%(KCI$RTEV) IBM default variables profile and %GBL_USER_JCL%(%RTE_NAME%) LPAR RTE user variables profile: 
    - KM5_NTH_DDS                   ""

Product-specific enhancements

The following product-specific enhancements are provided in this release:
IBM OMEGAMON for JVM on z/OS V5.4.0
  • Enhanced configuration that supports IBM Java Health Center Agent packaging in the following jobs:
    • KCIJPUSP z/OS® UNIX System Services preparation job
    • KCIJPUSS job

    Logic is added to generate the new KCIJARPX step in the KCIJPUSS job for OMEGAMON for JVM V5.4.0 and higher versions only. The packagings of the hca_31.pax and hca_64.pax Health Center Agent binaries are only made available starting in OMEGAMON for JVM V5.4.0. The KCIJARPX-related step that expands the pax files is generated commented out in an OMEGAMON for JVM V5.3.0 configuration. The bpxbatch pax steps that expand the hca_31.pax and hca_64.pax Health Center Agent binaries are also enhanced to switch dynamically to superuser (su) if the user ID submitting the KCIJPUSS job does not have a z/OS UNIX UID of 0.

  • Enhanced OMEGAMON for JVM Agent post-configuration:
    • Add the 31-bit JVM requirement for IMS JVMs if the IMS version is V13 and earlier, or if the IMS version is V14 and higher, but does not have IMS APAR PI64142 maintenance applied.

      The following text is added to the PARMGEN KJJDFINL Complete the configuration on-line README: 

      "Important: 
IMS supports 64-bit Java starting with IMS V14 with PI64142
maintenance. See "New function APAR that provides JVM 64 bit 
support" currency technote for more information (URL: 
http://www.ibm.com/support/docview.wss?crawler=1&uid=isg1PI64142
)."
    • Add additional considerations in the methods to configure JVMs in the different subsystems based on the copy of the Health Center Agent being used and what version of OMEGAMON for JVM Agent (KJJ) is running (FMID HKJJ530 GA-1 or the latest GA version FMID HKJJ540).
    • Add additional considerations in the Refresh jar files after SMP/E maintenance and recycle the components step: 
      *** Important recycle considerations *** 
In certain cases, you would also be required to recycle the following components:   
- OMEGAMON for JVM Agent (by default, IBMJJ Agent started task)  
* Your KJJ_AGT_STC = %KJJ_AGT_STC%                               
OMEGAMON for JVM Collector (by default, IBMJT Collector started task) 
* Your KJJ_COLLECTOR_STC = %KJJ_COLLECTOR_STC%                                                                                                                               
- each monitored JVM you may have enabled for detailed monitoring in the 
PARMGEN KJJDFINL post-configuration step 1 above.  
Refer to the HKJJvvv PTF maintenance HOLDDATA information for required enablement instructions.