PARMGEN PTF UA91953 for APAR OA52888 (3Q17 Interim Feature)
PARMGEN PTF UA91953 for APAR OA52888 (3Q17 Interim Feature) introduces several enhancements that benefit many of the products in the z Systems Management Suites that PARMGEN helps deploy, for example, the PARMGEN z/OS Discovery Library Adapter (DLA) integration enhancement.
Note that this APAR applies to all product versions. You do not have to upgrade to Tivoli® Management Services on z/OS® V6.3.0 Fix Pack 6 or later to take advantage of these features, but Tivoli Management Services V6.3.0 Fix Pack 6 or later is a prerequisite for
the OMEGAMON® XE version 5.3.0 family of products on the
distributed platform. Starting from OMEGAMON version 5.5.0 family products, Tivoli Management
Services V6.3.0 Fix Pack 6 or later is a prerequisite on both distributed and z/OS platforms because
the OMEGAMON V5.5.0 products are built on z/OS ITM 6.3.0 FP6 level of maintenance.
For product-specific enhancements, see the New in this release information for each OMEGAMON product. For a composite list of all the product-specific "What's New?" documentation, refer to OMEGAMON version 5.5.0 family products (3Q17 release).
If you upgrade a monitoring Agent and Tivoli Management Services, always review this topic related to any new PARMGEN profile parameters that you may need to add to your existing $GBL$USR global user profile if exploiting a product feature: Basic upgrade requirements
PARMGEN configuration framework enhancements and updates
The configuration software includes the following enhancements:- Updated the "Welcome to the z/OS Installation and Configuration Tools for IBM Tivoli Management
Services (TMS) dependent products" preparation topics such as "IBM z Systems 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". An thus you will know the following information ahead of time:
- How to deploy the SMP/E and configuration requirements of the various components included in the suites.
- Where to go next after the SMP/E and PARMGEN configuration phase of product deployment (especially components that use their own installation and configuration processes outside JOBGEN/PARMGEN controls).
- Which components need further post-configuration work.
-
Updated additional JOBGEN and PARMGEN on-line help to support the following changes:
- New version of IBM Service Management Suite for z/OS V1.5.0. Suite is refreshed to include new
versions of the following products:
- IBM OMEGAMON Enhanced 3270 User Interface V7.5.0
- IBM OMEGAMON Subsystem V7.5.0
- IBM OMEGAMON for CICS on z/OS V5.5.0
- IBM OMEGAMON for CICS TG on z/OS V5.5.0
- IBM OMEGAMON for IMS on z/OS V5.5.0
- IBM OMEGAMON for Messaging on z/OS - MQ V7.5.0
- IBM OMEGAMON for Messaging on z/OS - Integration Bus V7.5.0
- IBM OMEGAMON for Networks on z/OS V5.5.0
- IBM OMEGAMON for z/OS V5.5.0
- IBM OMEGAMON Dashboard Edition on z/OS V5.5.0
- IBM Tivoli Discovery Library Adapter V3.1.0 (JOBGEN support; now packaged in each OMEGAMON Family V5.5.0 standalone product package for PARMGEN use only)
- New version of IBM OMEGAMON Performance Management Suite for z/OS V5.5.0. Suite is refreshed to include new versions products refreshed in the IBM Service Management Suite for z/OS of applicable V1.5.0.
- New version of IBM OMEGAMON for z/OS Management Suite V5.5.0. Suite is refreshed to include new versions of applicable products refreshed in the IBM OMEGAMON Performance Management Suite for z/OS V5.5.0.
- Updated helps to include new version of IBM Advanced Storage Management Suite V2.2 which
includes support for the following products:
- IBM Cloud Tape Connector for z/OS V1.1.0 (JOBGEN support)
- IBM Advanced VSAM Manager for z/OS V2.6.0 (JOBGEN support)
- IBM Advanced Archive for DFSMShsm V1.1.0 (JOBGEN support)
- Updated helps to include new version of IBM DB2 Query Monitor for z/OS V3.3.
- Updated helps to remove the IBM OMEGAMON Serviceability Log Analysis references as this is now dropped from the Suites.
- New version of IBM Service Management Suite for z/OS V1.5.0. Suite is refreshed to include new
versions of the following products:
-
Provided "Display a consolidated list of 'What's New' component READMEs" in PARMGEN UTILITIES panel to document the new IBM Knowledge Center URL Keys for the new 3Q17 product versions:
=========================================================== ====== PRODUCT FAMILIES AND SUITES: KEY: =========================================================== ====== o. IBM Service Management Suite for z/OS SSANTA (URL: http://www.ibm.com/support/knowledgecenter/SSANTA) o. IBM OMEGAMON Performance Management Suite for z/OS SS7MFU (URL: http://www.ibm.com/support/knowledgecenter/SS7MFU) o. IBM OMEGAMON for z/OS Management Suite SS5PJ9 (URL: http://www.ibm.com/support/knowledgecenter/SS5PJ9) o. IBM Advanced Storage Management Suite for z/OS SSZKUS (URL: http://www.ibm.com/support/knowledgecenter/SSZKUS) o. Tivoli Monitoring SSTFXA (URL: http://www.ibm.com/support/knowledgecenter/SSTFXA) o. OMEGAMON Family SSAUBV (URL: http://www.ibm.com/support/knowledgecenter/SSAUBV) o. IBM Operations Analytics - Log Analysis SSPFMY (URL: http://www.ibm.com/support/knowledgecenter/SSPFMY) o. IBM Operations Analytics for z Systems SS55JD (URL: http://www.ibm.com/support/knowledgecenter/SS55JD) o. IBM Advanced Storage Management Suite for z/OS SSZKUS (URL: http://www.ibm.com/support/knowledgecenter/SSZKUS) o. Tivoli Advanced Allocation Management SSFLUS (URL: http://www.ibm.com/support/knowledgecenter/SSFLUS) o. Tivoli Advanced Audit for DFSMShsm SS4J89 (URL: http://www.ibm.com/support/knowledgecenter/SS4J89) o. Tivoli Advanced Backup and Recovery for z/OS SS4J7P (URL: http://www.ibm.com/support/knowledgecenter/SS4J7P) o. Tivoli Advanced Catalog Management for z/OS SS4J6U (URL: http://www.ibm.com/support/knowledgecenter/SS4J6U) o. Tivoli Advanced Reporting and Management for DFSMShsm SSLKZD (URL: http://www.ibm.com/support/knowledgecenter/SSLKZD) o. Tivoli Automated Tape Allocation Manager for z/OS SSATAY (URL: http://www.ibm.com/support/knowledgecenter/SSATAY) o. IBM Tivoli NetView for z/OS SSZJDU (URL: http://www.ibm.com/support/knowledgecenter/SSZJDU) o. IBM Tivoli for System Automation for z/OS SSWRCJ (URL: http://www.ibm.com/support/knowledgecenter/SSWRCJ) o. ITCAM for Application Diagnostics SSDTFJ (URL: http://www.ibm.com/support/knowledgecenter/SSDTFJ) o. ITCAM for SOA SS3PHK (URL: http://www.ibm.com/support/knowledgecenter/SS3PHK) o. Tivoli Decision Support for z/OS SSH53X (URL: http://www.ibm.com/support/knowledgecenter/SSH53X) =========================================================== ======
- Provided currency and toleration support for the following updates:
- Add z/OS 2.3
- Add CICS TS V5.4
- Drop DB2 V9.1 support in OMEGAMON for DB2 V5.4.0+
- Drop IMS V9.1, IMS V10.1, IMS V11.1 support in OMEGAMON for IMS V5.5.0+
This also includes product rebranding support for the following products:- OMEGAMON Family V5.5.0 products have removed "Tivoli" and "XE" as part of their official full product names.
- OMEGAMON Family V5.5.0 components have removed "on z/OS" as part of their official short product names similar to OMEGAMON Family V5.4.0 components such as OMEGAMON for JVM and OMEGAMON for Storage.
- OMEGAMON for CICS (formerly called OMEGAMON for CICS on z/OS)
- OMEGAMON for IMS (formerly called OMEGAMON for IMS on z/OS)
- OMEGAMON for Messaging - MQ (formerly called OMEGAMON for WebSphere MQ Monitoring)
- OMEGAMON for Messaging - Integration Bus (formerly called OMEGAMON for WebSphere MQ Broker)
- OMEGAMON for Networks (formerly called OMEGAMON for Mainframe Networks)
- OMEGAMON for z/OS (formerly called OMEGAMON on z/OS)
- Enhanced "Customize PARMGEN configuration profiles" processing by providing additional PARMGEN
KCIJPDLA autodiscovery functions for the following members in the RTE's WCONFIG dataset:
- WCONFIG(%RTE_NAME%) LPAR RTE user profile:
- Provided CICS TS V5.4 currency support. Autodiscover LPAR RTE user profile parameter for each CICS region to make it easier to set-up the On-line Data Viewer (ONDV) VSAM LDS RKC2HIST datasets for application history.
- KC2_HSnn_CLASSIC_CICS_REGION.Note: If z/OS Discovery Library Adapter FMID HIZD310's CICS TS V5.4 currency PTF UA92023 is applied, KC2_HSnn_CLASSIC_CICS_REGION LPAR RTE profile parameter is autodiscovered by the PARMGEN KCIJPDLA or KCIJPDL3 job if there are CICS TS V5.4 regions online.
- WCONFIG($GBL$USR) global RTE user profile:
- New GBL_DSN_CEE_SCEERUN2 parameter (autodiscovered value can be used for monitoring Agents that require the LE/370 "C" runtime library to be concatenated in the STC's STEPLIB DD).
- GBL_DSN_CICS_CTG_DLL parameter (autodiscovered value is concatenated in the OMEGAMON for CICS TG Agent started task's STEPLIB DD). In PARMGEN 3Q17 IF PTF UA91953, this value is prepopulated with the autodiscovered SCTGDLL dataset as the preferred library over the previous settings of SCTGLINK.
- GBL_DSN_NETVIEW_CNMLINK parameter (autodiscovered value is concatenated in the z/OS TEMS and Agent STCs' respective RKANMODL DD if you are enabling the ITM Forward Take Action commands to NetView for z/OS).
- GBL_DSN_IMS_SCEXLINK and GBL_DSN_IMS_SFUNLINK parameters (autodiscovered value is concatenated in the OMEGAMON for IMS Agent started task's STEPLIB DD to exploit the IMS Connect Extensions Publisher API).
- Updated WCONFIG(KJJ$SDL4) post-configuration imbed to OMEGAMON for JVM Agent's xKANSAMU(KJJDFINL) "Complete the configuration" tailored on-line README (autodiscovered z/OS Connect JVM started tasks and their respective STDENV data). This autodiscovery is further enhanced in 3Q17 IF to detect in-stream "STDENV DD *". The values are tailored into the OMEGAMON for JVM's post-configuration detailed monitoring enablement steps in the xKANSAMU(KJJDFINL) PARMGEN KJJ post-configuration tailored README).
- New WCONFIG(KJJ$SDL5) post-configuration imbed to OMEGAMON for JVM Agent's xKANSAMU(KJJDFINL) "Complete the configuration" tailored on-line README (autodiscovered IBM Operational Decision Manager (ODM) JVMs' HBRMSTR files).
- WCONFIG(%RTE_NAME%) LPAR RTE user profile:
- Provided additional PARMGEN z/OS DLA reports that aid staged maintenance and upgrades.
With the function-specific PARMGEN KCIJPDL1, KCIJPDL2 and KCIJPDL3 jobs, when to run these jobs provide the flexibility for customers to stage maintenance and upgrades to control when to refresh the following files:
- IDML books
- $DLARPT report
- LPAR RTE and $GBL$USR user profiles
=============================================================== DLA DLA Cmds. Member/Report Displayed and Function =============================================================== --------------------------------------------------------------- DLAMENU Starting in PARMGEN 3Q17 Interim Feature (IF) PTF UA91953, the various PARMGEN KCIJPDL* jobs, $DLA* reports and DLA* shortcut commands are provided in a menu format to make it easier to access key PARMGEN DLA autodiscovery tasks. You can access the PARMGEN DLA Menu (KCIPQDLA panel) by typing the 'DLAMENU' command from the UTILITIES (KCIPQPGU panel). The DLA artifacts are also still accessible via the UTILITIES panel. --------------------------------------------------------------- DLADLTA Review the RTE's WCONFIG($DLADLTA) DLA delta report. This report is created by submitting the KCIJPDLA composite job or the KCIJPDL2 "Generate PARMGEN $DLARPT report from DLA IDML books dataset" if both $DLARPT and $DLAMAP reports already exist in the RTE's WCONFIG dataset. 'DLADLTA' command displays the $DLADLTA delta report. This $DLADLTA delta report compares the previous $DLARPT report with the latest $DLARPT report run. The delta report highlights the changes in the %RTE_NAME% LPAR RTE user profile and the $GBL$USR global user profile. --------------------------------------------------------------- DLAMAP Review the RTE's WCONFIG($DLAMAP) parameter DLA map report. This report is created by submitting the KCIJPDLA composite job or the KCIJPDL3 "Refresh %RTE_NAME% / $GBL$USR user profiles with $DLARPT data" job. DLAMAP command displays the $DLAMAP report that maps what $DLARPT parameters equate to the equivalent PARMGEN %RTE_NAME% and $GBL$USR user profile parameters. --------------------------------------------------------------- Note: The PARMGEN KCIJPDL* jobs' comments and PARMGEN Utilities on-line help panel topics below also provide details on the new $DLAMAP and $DLADLTA reports: o From PARMGEN Utilities menu: "4 PARMGEN z/OS Discovery Library Adapter (DLA) support" "6 Additional Utility options/shortcut commands" o From the new PARMGEN DLA menu: "1 DLAMENU - PARMGEN DLA Menu - Overview" "2 PARMGEN z/OS Discovery Library Adapter (DLA) support" "3 DLA shortcut commands"
- Enhanced "Customize PARMGEN configuration profiles" processing by reducing product-specific LPAR
RTE profile parameters that are coupled with automatic discovery of system properties. Continuous
simplification of the deployment process is the key goal. With PARMGEN z/OS DLA autodiscovery
functions, the need to customize product parameter values are greatly reduced. With mostly
discovered data, streamlining how the product parameters are presented to the customers, is
simplified further in PARMGEN 3Q17 IF PTF UA91953 with useful parameter PF Key
macros:
o F23=BASIC to display only required product parameters or parameters with best-practice IBM defaults but may need to be overridden based on your site deployment needs. o F24=ADVANCED to display only advanced (optional and/or conditional) product parameters with best-practice IBM defaults but may need to be overridden based on your site deployment needs. o F22=SEARCH to search parameters in PARMGEN IK*/W*/RK* libs.
Basic (F23=BASIC PF Key) and Advanced (F24=ADVANCED PF Key) LPAR RTE profile parameter handling and ease-of-use grouping help a great deal especially for first-time-users.
All products that PARMGEN configures in the various product suites benefit from this enhancement. When an LPAR RTE profile is created in a new RTE, or is refreshed in an existing RTE that is being maintained or upgraded the WCONFIG dataset, the various product parameters will be grouped with these helpful sections:
The following products can take advantage of this streamlined Basic and Advanced LPAR RTE profile parameter grouping. The GA versions as well as any supported earlier versions benefit from this enhancement with PARMGEN 3Q17 IF PTF UA91953 applied:** ($$BEGIN - BASIC SECTION (&ppp - &component name) ** ($$END - BASIC SECTION (&ppp - &component name) ** ($$BEGIN - ADVANCED SECTION (&ppp - &component name) ** ($$END - ADVANCED SECTION (&ppp - &component name)
---- ----------------------------------------------------------- Kpp Component Name and GA Version ---- ----------------------------------------------------------- KAH System Automation Monitoring Agent V3.5.0 KCN OMEGAMON Subsystem V7.5.0 KC5 OMEGAMON for CICS V5.5.0 KDO Tivoli Decision Support for z/OS Agent V1.8.1 KDS Tivoli Enterprise Monitoring Server V6.3.0 KD4 ITCAM for SOA Agent V7.1.1 KD5 OMEGAMON for DB2 PE/PM V5.4.0 KGW OMEGAMON for CICS TG V5.5.0 KI5 OMEGAMON for IMS V5.5.0 KJJ OMEGAMON for JVM V5.4.0 KMC OMEGAMON for Messaging - WebSphere MQ Configuration V7.3.0 KMQ OMEGAMON for Messaging - MQ V7.5.0 KM5 OMEGAMON for z/OS V5.5.0 KNA NetView for z/OS Agent V6.2.1 KN3 OMEGAMON for Networks V5.5.0 KOB OMEGAMON Enhanced 3270 User Interface V7.5.0 KQI OMEGAMON for Messaging - Integration Bus V7.5.0 KRG Advanced Audit for DFSMShsm Agent V2.6.0 KRH Advanced Reporting and Management for DFSMShsm Agent V2.6.0 KRJ Advanced Allocation Management Agent V3.3.0 KRK Automated Tape Allocation Manager for z/OS Agent V3.3.0 KRN Advanced Catalog Management Agent V2.6.0 KRV Advanced Backup and Recovery for z/OS Agent V2.4.0 KRW Tape Optimizer for z/OS Agent V2.2.0 KS3 OMEGAMON for Storage V5.4.0 KWO OMEGAMON Dashboard Edition - OMEGAVIEW V5.3.0 KYN ITCAM for Application Diagnostics, TEMA V7.1.0.03
- Enhanced "Customize PARMGEN configuration profiles" processing by reducing over 575 total
product-specific LPAR RTE profile parameters for removed product features documented in the OMEGAMON
Family V5.5.0's respective product documentation. Refer to the "What's new in the OMEGAMON version
5.5.0 family products (3Q17 release)" topic in the OMEGAMON shared documentation, which has a
composite table that lists the products' "What's New" KC links. A number of these removed features
are as follows:
- For all OMEGAMON products:
- Removed the Common User Access (CUA) interface (also referred to as "OMEGAMON II") to reduce complexity and cost of ownership in the monitoring environment. SMEs experience improved ease of use since all key workspaces are now represented in the enhanced 3270 user interface (enhanced 3270UI) for additional problem solving capability. CUA is eliminated in Version 5.4 and Version 5.5 since functions which could be accomplished with CUA in previous releases, can now be accomplished with enhanced 3270UI.
- For staged upgrade planning, use the KCIJPW1R job to delete any obsolete runtime members that are no longer generated by the PARMGEN $PARSE* job for the product-specific deprecated functions (CUA-related product runtime members, Epilog-related product runtime members, and other obsolete functions) from the product-execution user libraries for each RTE to upgrade (RKANCMDU, RKANPARU, RKANSAMU, RKD2PAR, RKD2PRF and RKD2SAM), when the product started tasks are not in use. The PARMGEN $PARSE "(Re)create runtime members and jobs" will not generate these members in the PARMGEN WK* staging work user libraries (WKANCMDU, WKANPARU, WKANSAMU, WKD2PAR, WKD2PRF and WKD2SAM), once PARMGEN detects that the versions of the products installed in the %GBL_TARGET_HILEV%.TK*/CSI are at the latest V5.4/V5.5/V7.5 FMIDs. PARMGEN also has logic added to no longer generate over 575 product-specific LPAR RTE profile parameters in the WCONFIG(%RTE_NAME%) LPAR RTE user profile once you refresh the RTE supported by the "1. Set up/Refresh PARMGEN work environment" processing on the "PARAMETER GENERATOR (PARMGEN) WORKFLOW - PRIMARY OPTION MENU".
- PARMGEN KCIJPALO processing changes:
- If the minimum OMEGAMON version is V5.5.0, increase space allocation for the following datasets
to accommodate the V5.5 SMP/E requirements:
- read-only %RTE_X_HILEV_SHARING%.%RTE_SHARE%.RKANWENU shared dataset.
- RTE-specific %RTE_HILEV%.%RTE_NAME%.RKANDATV dataset
- If the minimum OMEGAMON for Networks FMID HKN3vvv version is V5.5.0, add logic in PARMGEN to no longer allocate the read-only %RTE_X_HILEV_SHARING%.%RTE_SHARE%.RKANSAS shared dataset.
- If the minimum OMEGAMON version is V5.5.0, increase space allocation for the following datasets
to accommodate the V5.5 SMP/E requirements:
- PARMGEN KCIJPLOD/KCIJPW1R/KCIJPW2R dependencies and changes:
- If the minimum OMEGAMON for Networks FMID HKN3vvv version is V5.5.0, add logic in PARMGEN to no longer load the read-only %RTE_X_HILEV_SHARING%.%RTE_SHARE%.RKANSAS shared dataset as the SMP/E target dataset %GBL_TARGET_HILEV%.TKANSAS is no longer shipped starting in HKN3550 FMID. The KCIJPLOD job is updated to no longer generate the KANSAS IEBCOPY step in this scenario.
- New DELRUN2 step is added to delete obsolete modules from the xKANMOD* load libraries, obsolete Object Definition Information (ODI) files from the RTE's RKANDATV, obsolete panels from the read-only RKANWENU, and obsolete screenspace from the read-only RKppPROC profile dataset, once PARMGEN detects that the minimum OMEGAMON version installed is V5.5.0/V7.5.0.
- New handy standalone KCIDELJB job is available for staged upgrades. This standalone job is the
equivalent of the BUILDEX*/DELRUN* steps of the composite KCIJPLOD job. Submit the composite
KCIDELJB standalone job, which deletes obsolete elements in read-only runtime dataset copies of the
%GBL_TARGET_HILEV%.TK* SMP/E target datasets. Run this job when the started
tasks are not running in order to do the clean-up.Tip: Related to using the KCIJPLOD job's new DELRUN2 step to clean-up these obsolete read-only elements from the read-only product execution datasets (RKANMOD* load libraries, RKANDATV ODI library, RKANWENU enhanced 3270UI workspace library, etc.), use the KCIJPW1R job to clean-up obsolete PARMGEN tailored runtime members from the product execution user libraries when the product started tasks are not running.
- PARMGEN KCIJPW1R/KCIJPW2R dependencies and changes:
For staged upgrade planning, use the KCIJPW1R job to delete any obsolete runtime members that are no longer generated by the PARMGEN $PARSE* job for the product-specific deprecated functions (CUA-related product runtime members, Epilog-related product runtime members, and other obsolete functions) from the product-execution user libraries for each RTE to upgrade (RKANCMDU, RKANPARU, RKANSAMU, RKD2PAR, RKD2PRF and RKD2SAM), when the product started tasks are not in use.
Tip: You do not have to delete these obsolete runtime members from the product execution user libraries (RK* user) immediately after SMP/E upgrade and reconfiguration of the RTEs pointing to the upgraded SMP/E target datasets. The product started tasks upgraded and loaded with the latest OMEGAMON V5.5 code will continue to run and tolerate the obsolete runtime members. You can continue to use the KCIJPW2R "Copy runtime mbrs from WK*->RK* RW libraries" to refresh the RK* user libraries after an upgrade following either the SMPE04, SMPE05, or SMPE06 upgrade scenario. - PARMGEN KCIJPSEC processing changes:
If the minimum OMEGAMON for IMS FMID HKI5vvv version is V5.5.0, add logic in PARMGEN to:
remove IMS V9.1-related module (KOICTJQ), IMS V10.1-related module (KOICTKQ) and IMS V11.1-related module (KOICTLQ) from COPYKOIM step and KOISUPDI PROC in the composite job and in the xKANSAMU(KOISUPD) standalone OMEGAMON for IMS security tailored job.Tip: Before you rerun KCIJPSEC job, you must take steps to disable/enable IMS related modules no longer shipped/newly shipped in the version of OMEGAMON for IMS installed by FMID HKI5vvv. For detailed information, see "Enabling the IMS version-related modules" topic in the OMEGAMON for IMS documentation. In summary, customize the WCONFIG(KI2$SSC*) override imbeds prior to rerunning the $PARSE* job, which refreshes the upgraded KCIJPSEC job. - PARMGEN KCIJPLNK processing changes:
- LKEDppp steps are no longer generated for OMEGAMON for IMS and OMEGAMON for Networks. Their corresponding standalone version of these link jobs (KI2BLDLI for OMEGAMON for IMS, and KONLINK for OMEGAMON for Networks) are also removed starting in V5.5.0.
- For OMEGAMON for IMS:
- IMS Console Facility (I/CF) is no longer supported, so the relevant messages, PARMGEN product parameters, runtime members, jobs and commands are removed. Use the new feature of IMS Commander, which is implemented within the OMEGAMON enhanced 3270 user interface.
- Individual settings as a configuration choice for the KI5_IInn_* KIPCNFG XE collectors are removed to simplify configuration. Instead, unless otherwise specified in PARMGEN, IMS Connect AUTODISCOVER is set to YES by default. PARMGEN logic is in place to continue to support the advanced KIPCNFG XE granular collectors in earlier versions of OMEGAMON for IMS, but it is recommended to take the PARMGEN LPAR RTE default settings.
- IMS Command Batch Message Processing interface (known as the BMP interface) that is designed to supplement the Write-to-Operator with Reply (WTOR) interface is no longer supported, so the PARMGEN product parameters, runtime members, jobs and commands are removed. Use the ICMD feature in the KIPCMD workspace from the OMEGAMON enhanced 3270 user interface.
- ATF Detail Exception Data DETXLOGR=%KI2_LOGR_LS_PREFIX%.&imsid.DX VSAM dataset is no longer allocated or processed in the KI2ATFmp runtime members.
- For OMEGAMON for z/OS:
- Epilog is no longer supported, so the relevant messages, PARMGEN product parameters, runtime members, jobs and commands are removed. Use the product's replacement feature, which is implemented within the OMEGAMON enhanced 3270 user interface.
- For OMEGAVIEW/OMEGAVIEW II for the Enterprise:
- Starting in OMEGAMON Dashboard Edition on z/OS V5.5.0, OMEGAVIEW Agent configuration is removed. Use the product's replacement feature, which is implemented within the OMEGAMON enhanced 3270 user interface.
- For End-to-End Response Time Monitor started task, this common component is applicable to the
following products only. ETE is no longer supported in the V5.5.0 Family:
- OMEGAMON for CICS V5.3.0 and earlier versions only
- OMEGAMON for IMS V5.1.0 and earlier versions only
- OMEGAMON for Networks V5.3.0 and earlier versions only
- OMEGAMON for z/OS V5.3.0 and earlier versions only
- PARMGEN KCIJPLOD processing changes:
If HKET620 End-to-End FMID is not installed, adjust the logic in PARMGEN when to generate the KANMODR IEBCOPY step from SMP/E %GBL_TARGET_HILEV%.TKANMODR target dataset to the read-only RKANMODR base dataset. TKANMODR is only SMP/E packaged by the HKET620 End-to-End FMID, the OMEGAMON for CICS FMID HKC5vvv and the OMEGAMON for IMS FMID HKI5vvv.
- PARMGEN KCIJPSYS processing changes:
With similar SMP/E requirements noted above, add logic in PARMGEN to no longer generate the ETE started task nor copy it to the system PROCLIB dataset (%GBL_DSN_SYS1_PROCLIB%), nor generate its START/STOP %RTE_CANSETE_STC% commands in the composite xxxxSTRT/xxxxSTOP tailored PROCs.
- For all OMEGAMON products:
- Provided additional IVP advanced validation checks:
- Detect an error condition when customer executes the "DLAJOB" shortcut command on the "Customize PARMGEN configuration profiles" KCIP@PG6 panel but the z/OS DLA SMP/E SIZD* target datasets do not exist or customer has a different zDLA high level qualifier (IZDHLQ parameter) in the DLADISC step of KCIJPDLA job.
- Detect an error condition when customer executes the "DLAJOB" shortcut command on the "Customize PARMGEN configuration profiles" KCIP@PG6 panel but the z/OS DLA FMID HIZD310 is not installed. Provide a warning that IZDHLQ must point to the SMP/E HLQ where you installed FMID HIZD310. UA78769 also introduced the SMPTLOAD requirement. See sample KCIDDFJB SMPTLOAD DDDEF job in %GBL_TARGET_HILEV%.TKANSAM(KCIDDFJB) for more information.
- Detect a warning condition when specifying a new GBL_USER_JCL PARMGEN JCL
library using a NONSMS-managed HLQ, but no required VOLUME and UNIT values were supplied on the
KCIP@TLV panel. In this case, provide a warning message to re-invoke PARMGEN using the INIT
invocation
option:
%GBL_USER_JCL% ALLOC failed! If using NONSMS HLQ, use %GBL_TARGET_HILEV%.TKANSAM(KCIALOJB). Or re-invoke PARMGEN and pass on the 'INIT' option. For example Command ==> EX '%GBL_TARGET_HILEV%.TKANCUS' 'INIT'"
- Enhanced the PARMGEN KCIJPDL* processing to generate helpful "* zDLA $DLARPT job no DB2 auth" in
the autodiscovered "KD2_DBnn_DB2_VER" OMEGAMON for DB2 LPAR RTE profile
parameter alerting customers when DB2 Authorizations have not been performed prior to using the
KCIJPDLA function. The KCIJPDL* jobs have been updated to list the DB2 specific SQL GRANT commands.
Note:Technote Preinstallation Requirements and Instructions has been updated with "Important System Requirements:" zDLA requirements.
- Provided JOBGEN support for IBM Tivoli Discovery Library Adapter FMID HIZD310.Tip: JOBGEN file-tailors SMP/E jobs that accommodate the SMP/E requirements of FMID HIZD310, ideally installed in an existing or new OMEGAMON/ITM CSI, where one can take advantage of using the PARMGEN z/OS DLA integration autodiscovery jobs (KCIJPDLA). Each OMEGAMON Family V5.5.0 standalone product package will now ship the z/OS DLA FMID HIZD310 by default (for PARMGEN use only).
- Provided a new "R" option to make it easier to (R)efresh the product
templates and IBM-supplied default profiles prior to recreating the product runtime members. This is
applicable to SMPE02 or
SMPE03 maintenance
scenario.
Description Job Name ---------------------------------------------- -------- R Refresh IK* templates/WCONFIG *$IBM profiles. KCIJPUP1 1. Create runtime members/jobs in all WK* libs. $PARSE ---------------------------------------------- --------
Product-specific enhancements
The following product-specific enhancements are provided in this release:- Tivoli Management Services: Engine infrastructure common to all z/OS TEMS and Agents
- The following features are added:
- (Common to all z/OS TEMS and z/OS Agents) Enhanced configuration to auto-discover the following
parameter values by the PARMGEN z/OS DLA integration:
- Auto-discover new $GBL$USR global user profile parameter GBL_DSN_CEE_SCEERUN2. The auto-discovered value can be used for monitoring Agents that require the LE/370 "C" runtime library to be concatenated in the STC's STEPLIB DD.
- Auto-discover $GBL$USR global user profile parameter
GBL_DSN_NETVIEW_CNMLINK. The auto-discovered value is concatenated in the z/OS
TEMS and Agent STCs' respective RKANMODL DD if you are enabling the ITM Forward Take Action commands
to NetView for z/OS. Tip: It is ideal to customize this library as part of initial RTE deployment even if the respective ITM features that require the CNMLINK dataset is not yet enabled. Auto-discovering this load library value ensures that PARMGEN sets up the product started tasks' STEPLIB DD to concatenate this dataset to avoid recycling the TEMS and Agent started tasks later.
- Auto-discover $GBL$USR global user profile parameter GBL_DSN_TCP_SYSTCPD_TCPDATA for SYSTCPD DD that is required for a number of ITM features if enabled (for example, if LPAR contains more than one TCP/IP stack).
- Provide a new handy RTE RKANSQLU(KDSSQLD) Sample SPUFIL Delete SQL statements member, to remove
obsolete product entries in the O4SRV.T* z/OS TEMS Enterprise Information Base (EIB) tables
(%RTE_VSAM_HILEV%.%RTE_NAME%.RKDS* VSAM datasets). PARMGEN KCIJPLOD job is updated to provide a new
SQLLIBCP IEBCOPY step to copy this new KDSSQLD member (along with the handy new KDSSQL1 SDA
TAPPLPROPS RKDSAPPL TEMS VSAM member introduced in PARMGEN 4Q16 IF), from the PARMGEN WKANSAMU work
staging dataset to the product-execution RTE RKANSQLU dataset. PARMGEN automatically concatenates
the RKANSQLU dataset in the TEMS' SQLLIB DD, where the TEMS SPUFIL processing is operationally
performed during TEMS CTDS SPUFIL invocation. Tip: On distributed platforms, performing this SPUFIL equates to the
tacmd deleteappinstallrecs
function. Having a handy KDSSQL* members supplied by PARMGEN provides an alternative to perform the function on the readily-available z/OS platform, if the distributed TEPS is not available or is not yet set-up. - Enhance RKANSAMU(KCIODIJB) standalone RKANDATV refresh job and the new cross-RTE
%GBL_USER_JCL%(KCIJ@ODI) RKANDATV refresh job to also generate a useful VVRRMMFF table which helps
with the distributed TACMD execution planning *PRIOR* to the various Agents' product
startup:
To generate the new cross-RTE %GBL_USER_JCL%(KCIJ@ODI) RKANDATV refresh job, type theExample KCIODIJB output: KCIRDATV - I (Reference) List of Product Code and Version for TACMD KCIRDATV - I TKANDATV pp VRMF = vvrrmmff KCIRDATV - I ======== == =============== KCIRDATV - I KAHVRTMS AH VRMF = 03500000 KCIRDATV - I KCPVRTMS CP VRMF = 05500000 KCIRDATV - I KDPVRTMS DP VRMF = 05400000 KCIRDATV - I KGWVRTMS GW VRMF = 05500000 KCIRDATV - I KIPVRTMS IP VRMF = 05500000 KCIRDATV - I KJJVRTMS JJ VRMF = 05400200 KCIRDATV - I KM5VRTMS M5 VRMF = 05500000 KCIRDATV - I KNAVRTMS NA VRMF = 06210000 KCIRDATV - I KN3VRTMS N3 VRMF = 05500000 KCIRDATV - I KQQVRTMS QQ VRMF = 03200000 KCIRDATV - I KRGVRTMS RG VRMF = 02600000 KCIRDATV - I KRHVRTMS RH VRMF = 02600000 KCIRDATV - I KRJVRTMS RJ VRMF = 03300002 KCIRDATV - I KRKVRTMS RK VRMF = 03300001 KCIRDATV - I KRNVRTMS RN VRMF = 02600000 KCIRDATV - I KRVVRTMS RV VRMF = 02400001 KCIRDATV - I KS3VRTMS S3 VRMF = 05400001
LOADDATV
command on the Runtime Environments (RTEs) panel (KCIP@RTE). Get to the Runtime Environments (RTEs) panel (KCIP@RTE) via one of the following ways:- Option 0 from the PARMGEN UTILITIES menu.
- Type a ? on the RTE_NAME field of the KCIPQPGA "PARAMETER GENERATOR (PARMGEN) WORKFLOW MENU.
- Add placeholder parameter support for the following parameters in the WCONFIG(KDS$PENV) imbed to
the TEMS xKANPARU(KDSENV) environmental file, which is read at TEMS STC
startup.
** o CMS_NODE_VALIDATION parameter enables the rejection of ** incorrect managed system names. - *CMS_NODE_VALIDATION=YES - *CMS_NODE_VALIDATION=&KDS_CMS_NODE_VALIDATION.
- Add best-practice user symbols for WCONFIG(KDS$PENV) placeholder parameters so they are ready
for the KCIPARSE step during variables substitution step at TEMS startup. IBM default variables
profile %GBL_USER_JCL%(KCI$RTEV) adds the following user symbol definition:
KDS_CMS_NODE_VALIDATION YES *default if used
- Enhance KCIJPUSP job's KDSUSSDV step to use RTE_USS_MKDIR_MODE parameter
value (default=775) to customize the oshell chmod %RTE_USS_MKDIR_MODE% z/OS
UNIX System Services command in the RKANDATV(KDSUSS) member.
This member copies the RKANDATV(KDSDPROF) TEMS_JAVA_BINPATH member to z/OS UNIX.Tip: The ability to customize the permission bits in the z/OS UNIX command caters to sites that implement the new UMASK() override permissions at the system level (for example, UMASK override of 0007 means no permissions altogether for the OTHER bit regardless what the PARMGEN
mkdir
commands created the directories in the KCIJPUSS job). - Update xKANSAMU(KDSDFINL) post-configuration step "Step 4 - Copy procedures to
%GBL_DSN_SYS1_PROCLIB%" to add this refresh note when adding products to an existing TEMS after
initial
configuration:
Note: - Certain products add special product-specific DDNAMEs to the %KDS_TEMS_STC% TEMS started task when the respective products are configured in the RTE. These products are as follows: o OMEGAMON for Messaging - MQ Configuration (KMC) Agent adds RKCF* DDNAMEs to the TEMS started task: Example: //RKCFDLOG DD DISP=SHR, // DSN=&RHILEV..&SYS..RKCFDLOG //RKCFAPLT DD DISP=SHR, // DSN=&RVHILEV..&SYS..RKCFAPLT //RKCFAPLA DD DISP=SHR, // DSN=&RVHILEV..&SYS..RKCFAPLA //RKCFAPLN DD DISP=SHR, // DSN=&RVHILEV..&SYS..RKCFAPLN //*DSNAOINI DD DISP=SHR, //* DSN=&RHILEV..&SYS..RKANPARU(KCFDBINI) o OMEGAMON for Storage (KS3) Agent adds SYSTSPRT and RKS3I* DDNAMEs to the TEMS started task: Example: //SYSTSPRT DD SYSOUT=&SOUT //RKS3IRDR DD SYSOUT=(,INTRDR) //RKS3IDCO DD DUMMY
- Update the PARMGEN F1=Help Parameter On-line Help text for the TEMS'
KDS_TEMS_STORAGE_MINIMUM_EXTEND LPAR RTE profile parameter in the
WCONFIG(%RTE_NAME%):
"Tip: The default values should work for most cases, but if you have a large shop and numerous ITM components (other TEMS, Agents) communicating to this TEMS running on this LPAR, or z/OS Agents running in this local TEMS address space, please review this documentation for best practice storage deployment considerations: http://www.ibm.com/support/docview.wss?uid=swg21501180"
KDS_TEMS_STORAGE_MINIMUM_EXTEND LPAR RTE profile parameter value populates the MINIMUM(%KDS_TEMS_STORAGE_MINIMUM_EXTEND%,X) parameter in the TEMS' RKANPARU(KDSSYSIN) runtime member. Default is MINIMUM(768000,X) parameter.
- (Common to all z/OS TEMS and z/OS Agents) Enhanced configuration to auto-discover the following
parameter values by the PARMGEN z/OS DLA integration:
- OMEGAMON Enhanced 3270 User Interface V7.3.0 and V7.5.0
- This is JOBGEN SMP/E installation and PARMGEN application configuration support for a new
version of IBM OMEGAMON Enhanced 3270 User Interface V7.5.0 and OMEGAMON Subsystem V7.5.0, which are
OMNIMON base features delivered in the HKOB750 FMID. The following configuration enhancements are
provided to support new features in this new version.
- Add placeholder parameter support for the following parameters in the WCONFIG(KOB$PENV) imbed to
the TOM xKANPARU(KOBENV) environmental file, which is read at OMEGAMON enhanced 3270UI
(%KOB_TOM_STC%) TOM STC startup.
- PNG_TIMEOUT=&KOB_PNG_TIMEOUT
- SO_TIMEOUT=&KOB_SO_TIMEOUT
- DIS_TIMEOUT=&KOB_DIS_TIMEOUT
- Add best-practice user symbols for WCONFIG(KOB$PENV) placeholder parameters so they are ready
for the KCIPARSE step during variables substitution step at TOM startup. IBM default variables
profile %GBL_USER_JCL%(KCI$RTEV) adds the following user symbol
definitions:
- KOB_PNG_TIMEOUT 1 *default if used - KOB_SO_TIMEOUT 15 *default if used - KOB_DIS_TIMEOUT 30 *default if used
- Update xKANSAMU(KOBDFINL) post-configuration step "(Optional) Complete enablement of alternate XKAN* Tivoli OMEGAMON (TOM) datasets for other integration products that deliver workspaces and other OMEGAMON enhanced 3270UI support elements" to document new version KQQ IBM DB2 Query Monitor for z/OS V3.3.
- Change default values of the following parameters in the WCONFIG(KOB$PENV) imbed to xKANPARU(KOBENV):
- PNG_TIMEOUT=2 to PNG_TIMEOUT=1
- DIS_TIMEOUT=2 to DIS_TIMEOUT=30
- Add placeholder parameter support for the following parameters in the WCONFIG(KOB$PENV) imbed to
the TOM xKANPARU(KOBENV) environmental file, which is read at OMEGAMON enhanced 3270UI
(%KOB_TOM_STC%) TOM STC startup.
- OMEGAMON for CICS V5.3.0 and V5.5.0
- This is JOBGEN SMP/E installation and PARMGEN application configuration support for a new
version of IBM OMEGAMON for CICS on z/OS V5.5.0 (HKC5550 FMID). The following configuration
enhancements are provided to support new features in this new version.
- Enhance configuration of KC2GLB globals customization in PARMGEN UTILITIES panel option
10. GBL_DSN_GLOBAL_SOURCE_LIB navigation by clarifying the usage of these
KC2GLB globals ONDV parameters:
<ONLINE_VIEWER> DATA_STORE_TYPE= DATA_STORE_FILE_NAME=
For customers enabling usage of the On-line Data Viewer (ONDV) task history RKC2HIST VSAM LDS as the storage type (DATA_STORE_TYPE=FILEOCMP or DATA_STORE_TYPE=AUTO), enablement instructions are needed in the OMEGAMON for CICS KC2GLB manage global documentation that customers must add the key DATA_STORE_FILE_NAME parameter in the KC2GLB global in use by the OMEGAMON for CICS Classic started task's RKC2GLBL DDNAME. The DATA_STORE_FILE_NAME parameter is not supplied by the OMEGAMON for CICS product by default, because its default ONDV task history storage is dataspace.
Enablement instructions are added to the PARMGEN globals in-context help. Syntax examples of DATA_STORE_FILE_NAME are also provided.
----------------------------------------------------------- KCIPGLH2 Product Global Data Area EDIT Help Panel ----------------------------------------------------------- Cursor: <ONLINE_VIEWER> * DATA_STORE_TYPE ----------------------------------------------------------- DATA_STORE_TYPE=DSPACE If this parameter is omitted, the default is DSPACE. DSPACE DSPACE indicates that data for task history collection is saved in a dataspace owned by the OMEGAMON for CICS (3270) interface. This data is saved until the task history collector terminates. FILEOCMP FILEOCMP indicates that task history data is saved in a VSAM linear dataset. No z/OS dataspace is used. FILEOCMP is required if you have a very large number of CICS transaction records that you wish to access through the ONDV command in OMEGAMON for CICS (3270) interface. The size of the VSAM file does not have an impact on the amount of virtual storage used in the OMEGAMON for CICS or CICS address spaces. FILEOCMP causes data to be compressed before it is written to the data store. The file should be allocated prior to restarting the CICS address space using this FILEOCMP monitoring option. Refer to the planning and configuration guide for further information. Note: You must add the DATA_STORE_FILE_NAME parameter if you are using DATA_STORE_TYPE=FILEOCMP or DATA_STORE_TYPE=AUTO. AUTO AUTO indicates that the value of DATA_STORE_TYPE could automatically be switched between DSPACE and FILEOCMP. The value FILEOCMP is used if the file which is specified for a CICS region exists. If no file matches the definition then the value DSPACE is used. Notes: This parameter is applicable to OMEGAMON for CICS V5.5.0 and higher versions only. You must add the DATA_STORE_FILE_NAME parameter if you are using DATA_STORE_TYPE=FILEOCMP or DATA_STORE_TYPE=AUTO. Whether you use a dataspace or linear dataset, the task history collector writes records using a wraparound format. Once the dataspace or dataset is full, the task history collector resumes writing records from the beginning, overlaying the previous data.
Cursor: <ONLINE_VIEWER> * DATA_STORE_FILE_NAME ----------------------------------------------------------- DATA_STORE_FILE_NAME= Specifies the name of a VSAM linear dataset when the DATA_STORE_TYPE=FILEOCMP or DATA_STORE_TYPE=AUTO is specified. You can share global data area modules (but not VSAM datasets) across different CICS regions even though a dataset name is specified in the global data area module. To do this, you must insert one wildcard character (*) somewhere in the VSAM dataset name on this operand. When the task history collector is running, the wildcard character is replaced by the job name of the CICS region being monitored. The wildcard character may appear anywhere in the dataset name and should occur only once. Syntax example: o DATA_STORE_FILE_NAME=&rtevhlq.&rte.*.RKC2HIST (where: - &rtevhlq = Your RTE_VSAM_HILEV VSAM HLQ value you specified during PARMGEN RTE configuration in the RTE's WCONFIG(%RTE_NAME%) LPAR RTE profile). - &rte = Your RTE_NAME LPAR RTE name) Note: In PARMGEN, review the KC2_HS* table parameter rows in the RTE's WCONFIG(%RTE_NAME%) LPAR RTE profile to enable the allocation of the ONDV task history VSAM LDS %RTE_VSAM_HILEV%.%RTE_NAME%.%KC2_HSnn_CICS_REGION%.RKC2HIST in the PARMGEN-tailored xKANSAMU(KC2HISJB) standalone OMEGAMON for CICS task history VSAM allocation job or in the xKANSAMU(KCIJPALO) composite dataset allocation job.
- Add new Step 8 - (Optional) Start/stop product functions dynamically step in xKANSAMU(KC5DFINL) post-configuration on-line README to provide a quick way to increase the OMEGAMON for CICS Agent's WLM BLOCKS parameter dynamically and thereby avoid recycling the OMEGAMON for CICS Agent.
- OMEGAMON CUA, Epilog and End-to-End features are no longer supported, so the relevant messages, PARMGEN product parameters, runtime members, jobs and commands are removed. Use the product-specific replacement features, which are implemented within the OMEGAMON enhanced 3270 user interface.
- Enhance configuration of KC2GLB globals customization in PARMGEN UTILITIES panel option
10. GBL_DSN_GLOBAL_SOURCE_LIB navigation by clarifying the usage of these
KC2GLB globals ONDV parameters:
- OMEGAMON for CICS TG V5.3.0 and V5.5.0
- This is JOBGEN SMP/E installation and PARMGEN application configuration support for a new
version of OMEGAMON for CICS TG V5.5.0 (HKGW550 FMID), which is part of the IBM OMEGAMON for CICS on
z/OS product package. The following configuration enhancements are provided to support new features
in this new version.
- Enhance configuration to autodiscovery the following parameter values by the PARMGEN KCIJPDLA
discovery job:
- Auto-discover LPAR RTE user profile parameter for each CICS TG Gateway Daemon STC name or the WebSphere region: KGW_SAnn_CTG_DAEMON_STC.
- Auto-discover $GBL$USR global user profile parameters GBL_DSN_CICS_CTG_DLL CICS TG Dynamic Link Library. Auto-discovered value is concatenated in the OMEGAMON for CICS TG Agent started task's STEPLIB DD. In PARMGEN 3Q17 IF PTF UA91953, this value is pre-populated with the auto-discovered SCTGDLL dataset as the preferred library over the previous settings of SCTGLINK.
- Enhance configuration to autodiscovery the following parameter values by the PARMGEN KCIJPDLA
discovery job:
- OMEGAMON for IMS V5.3.0 and V5.5.0
- This is JOBGEN SMP/E installation and PARMGEN application configuration support for a new
version of IBM OMEGAMON for IMS on z/OS V5.5.0 (HKI5550 FMID). The following configuration
enhancements are provided to support new features in this new version.
- Enhance configuration to auto-discover the following parameter values by the PARMGEN KCIJPDLA
discovery job:
- Auto-discover $GBL$USR global user profile parameters:
- GBL_DSN_IMS_SCEXLINK IMS Connect load library
- GBL_DSN_IMS_SFUNLINK IMS Connect load library
- GBL_DSN_IMS_RESLIB IMS RESLIB load library
- Auto-discover LPAR RTE user profile parameter for each IMS subsystem monitored:
- KI2_I1nn_CLASSIC_IMSID
- KI2_I1nn_CLASSIC_IMS_RESLIB
- Auto-discover $GBL$USR global user profile parameters:
- Automatically instantiate each IMS-subsystem specific parameter value for each IMS subsystem
discovered to ensure uniqueness as the product requires that each IMS subsystem is monitored by a
unique OMEGAMON for IMS MPREFIX, Classic started task, Classic VTAM major node, and Classic VTAM
APPLID, as shown in the example of 2 IMS subsystem rows
auto-discovered:
Example: - KI2_I101_CLASSIC_MPREFIX M0 - KI2_I101_CLASSIC_STC IBMOI0 - KI2_I101_CLASSIC_VTAM_NODE CTDOI0N - KI2_I101_CLASSIC_VTAM_APPL CTDOI0 - KI2_I102_CLASSIC_MPREFIX M1 - KI2_I102_CLASSIC_STC IBMOI1 - KI2_I102_CLASSIC_VTAM_NODE CTDOI1N - KI2_I102_CLASSIC_VTAM_APPL CTDOI1
- Change KI2_I1nn_CLASSIC_LROWS default value from 255 to 9999. Existing RTEs are not impacted. The new default value takes effect for new RTEs created after you apply PARMGEN 3Q17 IF PTF.
- Change LPAR RTE profile parameter KI5_X_AGT_STORAGE_LIMIT_EXTEND default
value from 23 to 24.
KI5_X_AGT_STORAGE_LIMIT_EXTEND LPAR RTE profile parameter value populates the LIMIT(%KI5_X_AGT_STORAGE_LIMIT_EXTEND%,X) parameter in the Agent's RKANPARU(KI5SYSIN) runtime member. New default is LIMIT(24,X) parameter (applicable to new RTEs created with PTF UA91953 applied).
- OMEGAMON CUA and End-to-End features are no longer supported, so the relevant messages, PARMGEN product parameters, runtime members, jobs and commands are removed. Use the product-specific replacement features, which are implemented within the OMEGAMON enhanced 3270 user interface.
- Enhance configuration to auto-discover the following parameter values by the PARMGEN KCIJPDLA
discovery job:
- OMEGAMON for Messaging (WebSphere MQ, a.k.a. MQ Monitoring) V7.3.0 and V7.5.0
- This is JOBGEN SMP/E installation and PARMGEN application configuration support for a new
version of IBM OMEGAMON for Messaging on z/OS - MQ V7.5.0 (HKMQ750 FMID). The following
configuration enhancements are provided to support new features in this new version.
- Enhance configuration to auto-discover the following parameter values by the PARMGEN KCIJPDLA
discovery job:
- Auto-discover $GBL$USR global user profile parameters for WebSphere MQ load libraries:
- GBL_DSN_WMQ_SCSQANLE
- GBL_DSN_WMQ_SCSQAUTH
- GBL_DSN_WMQ_SCSQLOAD
- Auto-discover WCONFIG(KMQ$CUSR) RKANCMDU(KMQUSER) imbed to add placeholder entries for discovered MQ Queue managers.
- Auto-discover $GBL$USR global user profile parameters for WebSphere MQ load libraries:
- Update the RTE xKANSAMU(KCIDFINL) post-configuration on-line README step "7c) Add the following modules to the IPL linklist" to add KMQAMHSE module introduced by HKMQ730 PTF UA82781. It reads: "KMQASSIN, KMQAMHST, KMQAMHSD, KMQAMHSE modules (OMEGAMON for Messaging) in load library (TKANMOD SMP/E target or read-only RTE RKANMOD dataset), if Application Statistics feature (MQI Monitoring), will be enabled".
- Change LPAR RTE profile parameter KMQ_X_AGT_STORAGE_LIMIT_EXTEND default
value from 23 to 24.
KMQ_X_AGT_STORAGE_LIMIT_EXTEND LPAR RTE profile parameter value populates the LIMIT(%KMQ_X_AGT_STORAGE_LIMIT_EXTEND%,X) parameter in the Agent's RKANPARU(KMQSYSIN) runtime member. New default is LIMIT(24,X) parameter (applicable to new RTEs created with PTF UA91953 applied).
- Remove the MQ3270 function in the RTE's RKANCMDU(KDSSTRT1) TEMS startup and in the RKANPARU
(KDSSYSIN) TEMS loadlist startup runtime members. The following statements are now removed once
OMEGAMON for Messaging - MQ V7.5.0 is configured or upgraded in the RTE where the TEMS is configured:
- From RKANCMDU(KDSSTRT1) TEMS startup:
- DIALOG %KDS_TEMS_VTAM_APPL_MQ% KMQDSTRT
- NTD KMQDPINI
- From RKANPARU(KDSSYSIN) TEMS startup:
- LOADLIST(KMQLLIST)
- From RKANCMDU(KDSSTRT1) TEMS startup:
- Enhance configuration to auto-discover the following parameter values by the PARMGEN KCIJPDLA
discovery job:
- OMEGAMON for Messaging (WebSphere Message Broker, a.k.a. IBM Integration Bus, Monitoring) V7.3.0 and V7.5.0
- This is JOBGEN SMP/E installation and PARMGEN application configuration support for a new
version of IBM OMEGAMON for Messaging on z/OS - Integration Bus V7.5.0 (HKQI750 FMID). The following
configuration enhancements are provided to support new features in this new version.
- Enhance configuration to auto-discover the following parameter values by the PARMGEN KCIJPDLA
discovery job:
- Auto-discover $GBL$USR global user profile parameter GBL_DSN_CEE_SCEERUN LE load library.
- Auto-discover LPAR RTE user profile parameter KQI_XML_XIMBNAME_MON_BRKR_NAME giving the name of the broker to be monitored.
- Auto-discover LPAR RTE user profile parameter KQI_XML_XIMBDIR1 giving the broker's ENVFILE z/OS UNIX path.
- Auto-discover WCONFIG(KQI$XML) RKANDATV(KQIXML) imbed to add XML entries for additional brokers to monitor.
- Auto-discover monitored brokers and list each discovered broker’s STDENV z/OS UNIX directory in the xKANSAMU(KQIDFINL) post-configuration tailored on-line README for KqiAgent.
- Modify the KQIXML product parameter default values as follows:
- KQI_XML_XIREQMDL_REPLY_QUE_MDL KQIXML's defaultReplyQueueModel default changed from SYSTEM.DEFAULT.MODEL.QUEUE to SYSTEM.BROKER.MODEL.QUEUE. This attribute specifies the name of the queue that will be used as a model for creation of the Agent reply queue for any queue manager to which the Agent connects. The PARMGEN KCIJPUSP job uses this value to build the RTE's RKANDATV(KQIXML).
- KQI_XML_XISSRET_SNAPSHOT_SAMPLE KQIXML's defaultRetainRecentSnapshotSamples default changed from 15 to 0 if you apply the HKQI730 FP2 PTF tracked in APAR OA51396 (and higher versions). Starting PARMGEN 3Q17 IF PTF UA91953, PARMGEN default will also support a null default setting (KQI_XML_XISSRET_SNAPSHOT_SAMPLE "") resulting in KCIJPUSP/KCIJPUSS job to generate defaultRetainRecentSnapshotSamples=" " value. This setting takes advantage of using the internal product code KQIXML default of "0" in the event that the HKQIvvv support is not applied. This attribute gives the minimum number of Snapshot Message Flow Accounting and Statistics samples that will be retained by the Agent for viewing in reports. This is a minimum, more may be retained at any given time. Note that this value should be set to 0 if you do not want the Agent to process Snapshot data from the broker at all. The PARMGEN KCIJPUSP job uses this value to build the RTE’s RKANDATV(KQIXML).
- Enhance configuration to auto-discover the following parameter values by the PARMGEN KCIJPDLA
discovery job:
- OMEGAMON for Messaging (WebSphere MQ Configuration) V7.3.0
- The following enhancements are added
- Enhance configuration to remove starting up the RKPDIN DD EXEC for KMCPDICT persistent datastore processing in a z/OS Remote TEMS. To save TEMS and Agent STC CPU overhead, PARMGEN logic checks are added to not start the KCFAUDIT history processing in the TEMS KPDPCTL, KPDPCTL2, and KPDDEFIN ITM persistent datastore runtime members in the RTE's RKANPARU dataset.
- Enhance configuration to auto-discover the following parameter values by the PARMGEN KCIJPDLA
discovery job:
- Auto-discover $GBL$USR global user profile parameters for WebSphere MQ load libraries:
- GBL_DSN_WMQ_SCSQANLE
- GBL_DSN_WMQ_SCSQAUTH
- Auto-discover $GBL$USR global user profile parameters for WebSphere MQ load libraries:
- OMEGAMON for z/OS V5.3.0 and V5.5.0
- This is JOBGEN SMP/E installation and PARMGEN application configuration support for a new
version of IBM OMEGAMON for z/OS V5.5.0 (HKM5550 FMID). The following configuration enhancements are
provided to support new features in this new version.
- OMEGAMON CUA, Epilog and End-to-End features are no longer supported, so the relevant messages, PARMGEN product parameters, runtime members, jobs and commands are removed. Use the product-specific replacement features, which are implemented within the OMEGAMON enhanced 3270 user interface.
- OMEGAMON for Networks V5.3.0 and V5.5.0
- This is JOBGEN SMP/E installation and PARMGEN application configuration support for a new
version of IBM OMEGAMON for Networks on z/OS V5.5.0 (HKN3550 FMID). The following configuration
enhancements are provided to support new features in this new version.
- Enhance configuration to auto-discover the following parameter values by the PARMGEN KCIJPDLA
discovery job:
- Auto-discover LPAR RTE user profile parameters for each TCP/IP stack monitored:
- KN3_TCPXnn_TCPIP_PROFILES_DSN
- KN3_TCPXnn_TCPIP_PROFILES_MBR
- Auto-discover LPAR RTE user profile parameters for each TCP/IP stack monitored:
- OMEGAMON CUA and End-to-End features are no longer supported, so the relevant messages, PARMGEN product parameters, runtime members, jobs and commands are removed. Use the product-specific replacement features, which are implemented within the OMEGAMON enhanced 3270 user interface.
- Enhance configuration to auto-discover the following parameter values by the PARMGEN KCIJPDLA
discovery job:
- OMEGAMON for JVM V5.4.0
- Enhance configuration to auto-discover the following parameter values by the PARMGEN KCIJPDLA
discovery job:
- Auto-discover the various JVM subsystem and application types running that are eligible for
monitoring, and their respective z/OS UNIX directories to make it easier for customer to add the
OMEGAMON for JVM monitoring Agent's (-javaagent) and IBM Java Health Center Agent's
(-Xbootclasspath, -agentpath) respective enablement options. List each discovered z/OS UNIX
directory or file location for these parameters in the xKANSAMU(KJJDFINL) post-configuration
tailored on-line README for KJJ Agent:
- JVMPROFILEDIR / USSHOME from CICS SIT for enabling the Health Center Agent and OMEGAMON for JVM Agent enablement options in CICS JVMs.
- STDENV for enabling the Health Center Agent and OMEGAMON for JVM Agent enablement options in CICS Transaction Gateway (CTG) JVMs.
- JVMOPMAS PROCLIB for IMS JMP for enabling the Health Center Agent and OMEGAMON for JVM Agent enablement options in IMS JVMs.
- STDENV for enabling the Health Center Agent and OMEGAMON for JVM Agent enablement options in WebSphere Liberty z/OS Connect EE JVMs.
- JVM_OPTIONS in HBRMSTR file for enabling the Health Center Agent and OMEGAMON for JVM Agent enablement options in ODM.
- Auto-discover the various JVM subsystem and application types running that are eligible for
monitoring, and their respective z/OS UNIX directories to make it easier for customer to add the
OMEGAMON for JVM monitoring Agent's (-javaagent) and IBM Java Health Center Agent's
(-Xbootclasspath, -agentpath) respective enablement options. List each discovered z/OS UNIX
directory or file location for these parameters in the xKANSAMU(KJJDFINL) post-configuration
tailored on-line README for KJJ Agent:
- OMEGAMON for DB2 PE/PM V5.3.0 and V5.4.0
- The following enhancements are added:
- Enhance configuration to auto-discover the following parameter values by the PARMGEN KCIJPDLA
discovery job:
- Auto-discover LPAR RTE user profile parameter for each DB2 subsystem to make it easier to
concatenate these DB2-subsystem-specific load libraries in the various OMEGAMON for DB2 BIND and
GRANT jobs per subsystem:
- KD2_DBnn_DB2_SSID
- KD2_DBnn_DB2_VER
- KD2_DBnn_DB2_LOADLIB
- KD2_DBnn_DB2_RUNLIB
- KD2_DBnn_PWH_LOADLIB
- KD2_DBnn_PWH_EXITLIB
- KD2_DBnn_DB2_SYSNAME
- Auto-discover $GBL$USR global user profile parameters to make it easier to concatenate these DB2
subsystem load libraries in the STEPLIB DDNAME of the OMEGAMON for DB2 Classic started task
(GBL_DB2_KD2_CLASSIC_STC) and other various OMEGAMON DB2 jobs:
- GBL_DSN_DB2_LOADLIB_V10
- GBL_DSN_DB2_RUNLIB_V10
- GBL_DSN_DB2_LOADLIB_V11
- GBL_DSN_DB2_RUNLIB_V11
- GBL_DSN_DB2_LOADLIB_V12
- GBL_DSN_DB2_RUNLIB_V12
- GBL_DSN_DB2_SDSNLOAD
- GBL_DSN_DB2_DSNEXIT
- Auto-discover LPAR RTE user profile parameter for each DB2 subsystem to make it easier to
concatenate these DB2-subsystem-specific load libraries in the various OMEGAMON for DB2 BIND and
GRANT jobs per subsystem:
- Generate helpful "* zDLA $DLARPT job no DB2 auth" in the autodiscovered
"KD2_DBnn_DB2_VER" LPAR RTE profile parameter alerting customers when DB2
Authorizations have not been performed for the KCIJPDLA job or KCIJPDL1 job. The KCIJPDL* jobs have
been updated to list the DB2 specific SQL GRANT commands to execute:
If RACF is used to protect DB2 resources, then authority is required to issue DB2 DISPLAY commands and to access (READ) SYSIBM resources using dynamic SQL. In addition, for the DB2 version autodiscovery, the z/OS DLA extracts the DB2 version via the Instrumentation Facility Interface (IFI).
The IZDPDISC PROC and the auth. ID that runs the KCIJPDLA or KCIJPDL1 job must have the appropriate authorization to issue the DB2 commands for each DB2 subsystem.
DB2 Authorities for each DB2 subsystem: Take SQL statements to authorize &user="IZDPDISC" as an example:GRANT DISPLAY,MONITOR1,MONITOR2 TO "IZDPDISC"; GRANT SELECT ON SYSIBM.SYSDATABASE TO "IZDPDISC"; GRANT SELECT ON SYSIBM.SYSTABLESPACE TO "IZDPDISC"; GRANT SELECT ON SYSIBM.SYSTABLES TO "IZDPDISC"; GRANT SELECT ON SYSIBM.SYSINDEXES TO "IZDPDISC"; GRANT SELECT ON SYSIBM.SYSCOLUMNS TO "IZDPDISC"; GRANT EXECUTE ON PROCEDURE SYSPROC.DSNWZP TO "IZDPDISC";"
- Update xKANSAMU(KD5DFINL) post-configuration step "(Optional) Complete enablement of alternate XKAN* Tivoli OMEGAMON (TOM) datasets for other integration products that deliver workspaces and other OMEGAMON enhanced 3270UI support elements" to document new version KQQ IBM DB2 Query Monitor for z/OS V3.3.
- Enhance configuration to auto-discover the following parameter values by the PARMGEN KCIJPDLA
discovery job:
- OMEGAMON for Storage V5.3.0 and V5.4.0
- Add xKANSAMU(KS3DFINL) post-configuration step "Step 1 - Refresh procedures to
%GBL_DSN_SYS1_PROCLIB%".
a) Refresh the TEMS started task (%KDS_TEMS_STC%) from RKANSAMU to %GBL_DSN_SYS1_PROCLIB%. Notes: - Certain products add special product-specific DDNAMEs to the %KDS_TEMS_STC% TEMS started task when the respective products are configured in the RTE. These products are as follows: o OMEGAMON for Storage (KS3) Agent adds SYSTSPRT and RKS3I* DDNAMEs to the TEMS started task: Example: //SYSTSPRT DD SYSOUT=&SOUT //RKS3IRDR DD SYSOUT=(,INTRDR) //RKS3IDCO DD DUMMY"