PARMGEN PTF UA76016 for APAR OA46184 (1Q15 Interim Feature)
PARMGEN PTF UA76016 for APAR OA46184 (1Q15 Interim Feature) introduces several enhancements affecting all products that use the configuration software.
The configuration software includes the following enhancements:
New WCONFIG RTE LPAR profile parameters
- Provide the flexibility to override the JCL REGION value in all PARMGEN jobs, including the KCIJPCFG, KCIJPPRF, KCIJPUP1, and $PARSE* related jobs in “Set-up PARMGEN work environment”. KCIP@PG2 panel externalizes the new GBL_REGION field for customer overrides.
- 3 New global RTE_* parameters to support the SmartCloud Analytics - Log Analysis (SCA-LA) and
Tivoli Enterprise Portal (TEP) integration parameters.
- RTE_SCALA_ENABLED_FLAG
- RTE_SCALA_HOST
- RTE_SMFID
- Parameter RTE_KCIJPSYS_INCLUDE_STEP_KDS provides the flexibility to exclude generating the ASMKDS KDSMTAB1 LU62 logmode table assembly and link step in the xKANSAMU(KCIJPSYS) system copy and processor job.
- Parameter RTE_X_STC_INAPF_MEMBER_NAME defines the optional INAPF name (default is IBMAPF). Override the INAPF member name in the RTE_X_STC_INAPF_MEMBER_NAME parameter if the default IBMAPF member needs to cater to multiple versions of the product started tasks in a given LPAR.
- RTE_X_STC_START_MEMBER_NAME and RTE_X_STC_STOP_MEMBER_NAME parameters define optional composite START/STOP PROC names (default is IBMSTRT/IBMSTOP, respectively). Override the /S, /P composite STCs if the default IBM* names need to cater to multiple versions of the product started tasks in a given LPAR.
- KI2_ICnn_* parameter is for OMXE for IMS, support new KI2_IC* I/CF profile parameters to support I/CF Console Commands or the I/CF Trap Command parameters generated in the OMXE IMS RKANCMDU(KI2START) startup member.
Changed default values for existing WCONFIG RTE LPAR profile parameters
- KDS_KMS_SDA for TEMS is set to “N” by default. Prior default was not set to any value (KDS_KMS_SDA was commented out in the LPAR RTE profile).
- Kpp_AGT_STORAGE_MINIMUM_EXTEND for common TEMS and agents increases the new default value to MINIMUM(384000,X) and support QUIESCE(96,X,F) and QUIESCE(99,X,C) xKANPARU(KppSYSIN) TMS:Engine startup parameters for TEMS and all Agents.
- KD2_PFnn_HIS_BUFSIZE for OMXE for DB2 changes Thread Near-term History (NTH) buffer size from 1024 to 2048.
- KD2_DBnn_PWH_D2PWSTBP for OMXE for DB2 changes default of Performance Warehouse bufferpool from BP0 to BP32K.
- KD2_PFnn_HIS_LOGn for OMXE for DB2 changes default Thread NTH VSAM log datasets from 3 VSAMs to 7 VSAMs (RKD2VSnn).
- Comments updated in the KM5_* RTE profile to add note about Non-Sysplex RTEs.
- KMV_X_AGT_STORAGE_LIMIT_PRIMARY for OMEGAMON DE on z/OS increases OMEGAVIEW LIMIT() primary storage request from 17,P to 19,P.
New WCONFIG(Kpp$*) override imbeds
- New WCONFIG(KCI$SLOG) for RKLVSNAP/RKLVLOG. TMS:Engine-based product started tasks (TEMS, CUA, Agents) will remove these DDs from the product started tasks, and instead, PARMGEN will replace the DDs with a customer-controlled WCONFIG imbed called WCONFIG(KCI$SLOG) that gets imbedded during $PARSE* job.
- New WCONFIG(Kpp$SDMP) SYS%DUMP DD - TMS:Engine-based product started tasks (TEMS, CUA, Agents)
that currently have a SYSUDUMP DD, will remove it from the product started tasks that currently
hardcode a SYSUDUMP DD, and instead, PARMGEN will replace as a customer-controlled WCONFIG imbed
called WCONFIG(Kpp$SDMP) (one per product). Current products that have a hardcoded SYSUDUMP DD are:
- TEMS (KDS)
- OMEGAMON XE for Storage CUA (KDF)
- OMEGAMON XE for IMS (Classic KOI STC per IMS subsystem and CUA KI2)
- OMEGAVIEW (KMV)
- OMEGAMON XE on z/OS Classic KOM and CUA KM2
- OMEGAMON XE for Mainframe Networks CUA (KON).
- New WCONFIG(KDF$PSCN) imbed for MSR monitoring and dataset monitoring devices options member in xKANPARU(KDFDSCIN).
- New WCONFIG(KR%$PCON) imbeds for Tivoli Advanced Storage Agents' (KRG KRH KRJ KRK KRN KRV KRW) product-specific imbed to KR%CONFG runtime members (IRAMAN startup members).
Updated WCONFIG(Kpp$*) Override Imbeds
- WCONFIG(KMQ$CUSR) imbed to W/RKANCMDU(KMQUSER) for OMXE for Messaging, updated the KMQUSER imbed comments to highlight the importance of supported dynamic commands.
- WCONFIG(KDS$PENV/KAG$PENV/KDF$PENV/KM2$PENV) imbed to W/RKANPARU(KppENV) for common KDS TEMS/common KAG* Agents/OMXE Storage and z/OS CUAs (KDF/KM2), updated the KppENV imbed to add the enabled parameter “KDE_ALLOWNETIDMISMATCH=1” by default.
- WCONFIG(KDS$PENV) imbed to W/RKANPARU(KDSENV) for common KDS TEMS, updated the TEMS KDSENV imbed to add the recommended enabled parameters “MAX_CTIRA_RECURSIVE_LOCKS=150” and “KDEP_SERVICETHREADS=63” by default.
- WCONFIG(KD5$PENV) imbed to W/RKANPARU(KD5ENV) for OMXE for DB2, updated the KD5ENV imbed to add highlighted comments and placeholder “CTIRA_SUBSYSTEM_ID” parameter to feature advanced Agent implementation when there are multiple instances of the OMXE DB2 Agent in a given LPAR reporting to the same TEMS.
New PARMGEN WK* Members or Jobs
- WKANSAMU(KCIJPCOL) PDCOLLECT tailored job is a new diagnostic job created by PARMGEN to collect diagnostic information. You can select the new job on the PARMGEN Utilities menu.
- WKANSAMU(KCIJPHRC) HRECALL sample tailored job is a new utility job created by PARMGEN to help recall the RTE datasets.
- xKANPARU(KppCONFG) is new runtime members file-tailored by PARMGEN for the Tivoli Advanced Storage Agents' (KRG KRH KRJ KRK KRN KRV KRW) IRAMAN startup members. Prior to this enhancement, the product FMIDs delivered default members that required customers to manually copy to RKANPARU dataset and manually add “HLQ=” customization.
- WCONFIG($MBDINDX) is a new WCONFIG imbed table listing in $MBDINDX (extracted from WCONFIG($JOBINDX)); both index members accommodate the new KCI$SLOG and Kpp$SDMP log-dump-related override imbeds, as well as the new Kpp$PCON imbeds to the Tivoli Advanced Storage Agents’ xKANPARU(KppCONFG) IRAMAN startup runtime members
Changed PARMGEN WCONFIG or WK* Members or Jobs
Changed PARMGEN profiles and jobs:
- IKANSAMU(KCI$RTEV)/&gbl_user_jcl(KCI$RTEV) &gbl_user_jcl(&rte_name) for all products: updated the Variables profile resolution member with additional best practice user symbols (STGDEBUG_*, TCP_STC, etc). Note that existing &gbl_user_jcl(&rte_name) variables profile is preserved, so compare the IBM-supplied PARMGEN variables profile in IKANSAMU(KCI$RTEV) or &gbl_user_jcl(KCI$RTEV) with your user customized variables RTE profile in &gbl_user_jcl.
- WCONFIG($PARSE*) for all products: new WSUPERC step added in all $PARSE*-related jobs.
- WCONFIG($PARSE*) for all products: significant batch job run elapsed time improvement.
- WCONFIG($PARSE*) for OMXE for DB2: automate generating the SUBMIT command for the appropriate CRTDB2* job depending on the KD2_OMPE_USE_MODEL parameter setting.
- WCONFIG(KCIJPVAL) for common TEMS and agent exploiters of ICSF: PARMGEN validation job detects
if ICSF load library is not set. This is required starting from ITM630.
- By default this parameter is commented out. You must customize this parameter in WCONFIG($GBL$USR).
- Additional WCONFIG(KCIJPVAL) validation checking added:
- VALIDATE 1: If the default GBL_DSN_SYS1_* libraries are using default value SYS1.* dataset names, provide a warning when customer submits the optional KCIJPSYS system copy job.
- For all PARMGEN jobs, enabled the customizable GBL_REGION WCONFIG(&rte_name) and WCONFIG($GBL$USR) profile parameter in all PARMGEN KCIJ* jobs and all PARMGEN product-specific jobs.
- For all PARMGEN profiles and jobs, added z/OS and ISPF environment information in PARMGEN jobs and READMEs for reference.
Changed runtime members:
- WKANPARU(KppENV) for common TEMS and agents: added new CTIRA_SYSTEM_NAME and CTIRA_HOSTLOC parameters in the TEMS and agents’ xKANPARU(KppENV) runtime members. By default, the parameters are generated commented out by the PARMGEN $PARSE* job. If the value of RTE_SCALA_ENABLED_FLAG is changed from N to Y in the WCONFIG(&rte_name) LPAR RTE profile, the CTIRA_* parameters in the KppENV runtime members are generated enabled(uncommented out).
- WKANPARU(KppSYSIN) for common TEMS and agents: added QUIESCE(96,X,F) and QUIESCE(99,X,C) parameters to all TEMS and agent xKANPARU(KppSYSIN).
- WKANPARU(KppSYSIN) for common agents: for any agents that run in their own agent address space that do not currently default its MINIMUM() storage setting to 384000, the PARMGEN configuration default is now MINIMUM(384000,X) in xKANPARU(KppSYSIN).
- xKANPARU(KppPRD00) for Tivoli Advanced Storage agents: these runtime members are no longer generated in the newer versions of the respective KR* TEMA-based Agents.
- OMEGAMON DE on z/OS: Support MV-only no TEMS/no KWO configuration.
- WKANPARU(KMVINIT): added checking to detect if related 3 parameters should be generated based on TEMS connect flag.
- WKANCMDU(KMVSTKMV): added checking to detect if the KMV agent startup should be generated based on TEMS connect flag.
- WCONFIG(&rte_name): updated comment section in the 2 key parameters that control these flags: KMV_TEMS_LOCAL_CONNECT_FLAG and KMV_OMEGAVIEW_II_ENTERPRISE
- OMXE for CICS Classic STC in xKANSAMU: increased the default REGION size from 4096K to 0M, and provided externalization support to customize REGION via GBL_REGION parameter.
- All product started tasks, KCIJ* PARMGEN composite jobs, product-specific utility jobs in xKANSAMU: provided externalization support to customize REGION via new GBL_REGION parameter.
- All product started tasks in xKANSAMU: added “Last $PARSE* run refresh: TEMS version @ FMID HKDS630” header.
- All product started tasks in xKANSAMU: modified PROCSTEP with more function-centric names instead of the started task name.
- All product started tasks in xKANSAMU: added support for customizable log and dump-related
product started task DDNAMEs.
- RKLVSNAP/RKLVLOG: TMS:Engine-based product started tasks (TEMS, CUA, Agents) will remove these 2 DDs from the product started tasks, and instead, PARMGEN will replace as a customer-controlled WCONFIG imbed called WCONFIG(KCI$SLOG).
- SYS%DUMP DD: TMS:Engine-based product started tasks (TEMS, CUA, Agents), that currently have a SYSUDUMP DD, will remove it from the product started tasks that currently hardcode a SYSUDUMP DD, and instead, PARMGEN will replace as a customer-controlled WCONFIG imbed called WCONFIG(Kpp$SDMP). There will be one WCONFIG imbed per product.
- WKANSAMU(KppDFINL): updated the "Perform post configuration steps" READMEs.
- WKANSAMU(KCIDFINL) "KCI" step 2 and step 3 for all products: added new tables for the complete list of product started tasks and product VTAM elements (major node and APPLIDs) categorized by product and suite.
- WKANSAMU(KCIDFINL) for all products: added a complete list of all product VTAM node and APPLIDs table in the "POSTCFG" on-line README.
- WKANSAMU(KCIDFINL) for all products: added post-configuration step 12 to highlight the importance of dynamic commands.
- WKANSAMU(KAGDFINL) for common Agent post-configuration README: added new table for the complete list of products that configure the ITM persistent datastore (short-term, NTH).
- WKANSAMU(KD5DFINL) for OMXE for DB2: added new post-configuration step 7 for RRSAF.
- WKANSAMU(KD5DFINL) for OMXE for DB2: added new post-configuration steps 10 and 11 to highlight the importance of dynamic commands.
- WKANSAMU(KI5DFINL) for OMXE for IMS: added new post-configuration step 12 to highlight the importance of dynamic commands.
- WKANSAMU(KMQDFINL) for OMXE for Messaging: added post-configuration step update to step 1b to highlight the importance of dynamic commands.
- WKANSAMU(KOBDFINL) for enhanced 3270UI: added new steps to highlight the enhanced 3270UI NTH post-configuration step.
- WKANSAMU(KM5DFINL) for OMXE on z/OS: added new step to highlight the enhanced 3270UI NTH post-configuration step.
- WKANSAMU(KGWDFINL) for OMXE for CICS TG: added new step to point to the technote (if TxnMonitor Exit (kgw_monitor.jar) monitoring values need to be changed post-install).
- WKANSAMU(KD5DFINL) for OMXE for DB2: added post-configuration step for dynamic START/STOP of Object Analysis.
Changed and new PARMGEN workflow UI panels
PARMGEN Workflow UI panel changes:
- KCIPQPGW “ Welcome to the z/OS Installation and Configuration Tools for IBM Tivoli Management Services (TMS) dependent products”: updated SMC panel to add "try" and the new suites (OMEGAMON Performance Management Suite, IBM Service Management Suite for z/OS).
- “PARAMETER GENERATOR (PARMGEN) WORKFLOW - PRIMARY OPTION MENU”: clarified KCIJPCFG option.
- “SET UP PARMGEN WORK ENVIRONMENT FOR AN RTE (2 OF 3)” KCIP@PG2 panel:
- Added new GBL_REGION field.
- Added logic to only display the GBL_INST_HILEV field only if this is an ICAT to PARMGEN conversion.
- "CUSTOMIZE PARMGEN CONFIGURATION PROFILE MEMBERS": clarified option labels.
- "SUBMIT BATCH JOBS TO COMPLETE PARMGEN SETUP": clarified KCIJPUSP/KCIJPUSS options.
- UTILITIES: clarified KCIJPW1R function (equivalent to KCIJPMTY and KCIJPW2R - handy when deleting products from an RTE).
- KCIP@SEC panel: added note about the ICAT to PARMGEN conversion consideration.