A fix is available
APAR status
Closed as new function.
Error description
JOBGEN, PARMGEN and ICAT framework updates RFE: Provide PARMGEN Workflow UI improvements for: A. PARMGEN Configuration Framework Enhancements/Updates: Enhance the KCIJPW2R WK*->RK* Deployment job to provide support for non-PARMGEN controlled members to be preserved in the RK* user libraries and provide a user-controlled list of EXCLUDE members. ØBenefit: Save time from having to manually copy back non-PARMGEN-tailored (but required) user customized members. Implement KOBSUPDT OMEGAMON security standardization (Phase 1) of where the KppSUPDI (KOCSUPDI, KO2SUPDI, KOISUPDI, and KOMSUPDI) Classic command table exits can be maintained for user customizations so the composite KCIJPSEC security job can take advantage of using the commonRTE_X_SECURITY_EXIT_LIB as the standard security user exit library. See master PARMGEN technote FAQ#37 for more information. ØBenefit: Reduce the post-configuration security steps and give customers one place to lock-down the security exits. Enhance PARMGEN-created product started tasks and jobs to add a helpful PARMGEN accounting header. - WCONFIG(KCIJPCFG) and WCONFIG(KCIJPUP1) - add the following maintenance level eyecatcher. ØBenefit: for ease-of-use identifying what level of PARMGEN maintenance the job is generated from: //* **************************************************************** *** //* PARMGEN Maintenance Level: FMID HKCI310 PTF UA67172 APAR OA40035 - All jobs in WKANSAMU - add the following maintenance level eyecatcher. ØBenefit: for ease-of-use identifying what level of PARMGEN maintenance the job is generated from: //* **************************************************************** *** //* PARMGEN Maintenance Level: FMID HKCI310 PTF UA67172 APAR OA40035 - All generated STCs in WKANSAMU - add the following PARMGEN accounting header. Initial IBM-supplied default contains: PARMGEN maintenance info: ØBenefit: So customers know what level of PARMGEN maintenance/IF generated this version of the STC PARMGEN work environment: ØBenefit: So customers easily find the PARMGEN work libraries if the PARMGEN work libraries HLQ (RTE_PLIB_HILEV) is different from the RTE HLQ (RTE_HILEV); user-supplied GBL_DSN_SYS1_PROCLIB so customers know which user-supplied system procedure library was tailored into the PARMGEN WKANSAMU(KCIJPSYS) system copy job where the STCs were copied to. PARMGEN Jobcard (commented out version of the user's WCONFIG($JOBCARD))/SYSDATE:ØBenefit: So customers know which user/jobname created the STC that is running in production and when last modified by a PARMGEN job. Customers will have one member (new WCONFIG(KCI$SST1) to customize all the contents of the PARMGEN accounting header if they wish to add/remove any of the IBM-supplied initial contents to this imbed. ===END "Sub-section: A. 4Q12A RFEs>>A. Configuration Framework Enhancements/Updates:" B. PARMGEN-supported Application Configuration Enhancements/Updates: Tivoli Enterprise Monitoring Server (TEMS) and OMEGAMON Enhanced 3270UI: Support a user-controlled "KDS_X_TEMS_KDSSTRT1_DELAY_INT" parameter to control the interval when the TEMS issues the Agent startup commands, including the OMEGAMON Enhanced 3270 Data Retrieval Agent (DRA) included in the xKANCMDU(KDSSTRT1) member. OMEGAMON Enhanced 3270UI: Remove the following note in the RTE_SECURITY_CLASS Global SAF security class name: "If using ACF2 as your external security resource manager, specify a maximum of three characters." as this requirement does not apply to e3270UI. Common Agent configuration: Provide sample Agent Autonomy-related default parameters as placeholders in the WCONFIG(KAG$PENV) common Agent xKANPARU(KppENV) standalone Agent environment member. Please refer to the IBM Tivoli Monitoring Administrator's Guide for more information if you wish to exploit these features. Common Persistent Datastore: Default the Persistent Datastore related SMS parameters with the global RTE SMS-related VOLUME, UNIT, STORCLAS, and MGMTCLAS automatically. OMEGAMON XE for CICS on z/OS V4.2.0 and higher versions: Provide a standalone RKC2HIST task history VSAM (&rvhilev.&rte.%KC2_HSnn_CLASSIC_CICS_REGION%.RKC2HIST) allocation job called xKANSAMU(KC2HISJB) to make it easier to allocate the task history datasets without rerunning the composite xKANSAMU(KCIJPALO) allocation job. OMEGAMON XE for CICS on z/OS V4.2.0 and higher versions: Increase the PARMGEN KCIJPALO allocation/initialization support for task history VSAM libraries (%RTE_VSAM_HILEV%.%RTE_NAME%.%KC2_HSnn_CLASSIC_CICS_REGION%.RKC2 HIST) for CICS regions greater than 99 CICS regions. OMEGAMON XE for DB2 PE/PM V4.2.0 and higher versions: Allocate the TMPD2* DDNAMEs for temporary datasets in the CANSO2 and CANSD2 started tasks with a SPACE() allocations large enough to accommodate resolving the runtime members for > 45 DB2 subsystems. OMEGAMON XE for DB2 PE/PM V4.2.0 and higher versions: Provide System Variables support for xKD2SAM(FPEJINIT) sample REXX program to Invoke OMEGAMON XE for DB2 PE on z/OS ISPF Application. OMEGAMON XE for DB2 PE/PM V4.2.0 and higher versions: Autodiscover the system values for the initial default of the following parameters: KD2_OMPE_TCPIP_NAME (used in TCPNAME= parameter in xKD2PAR(OMPEMSTR) and KD2_CLASSIC_MVS_SYSID (used in DB2_SYSID= parameter in xKD2PRF(DB2PROF) and xKD2PRF(CRTDB2M) so that the initial PARMGEN RTE CONFIG profile values for these parameters automatically are set-up automatically in the system where the WCONFIG(KCIJPUP1) job is submitted. OMEGAMON XE for IMS on z/OS V4.2.0 and higher versions: Enhance xKANPARU(KOIJLF00) Journal Logging Facility (JLF) startup member to provide full-tailoring capabilities so customers are able to fully-customize the different JLF startup options that PARMGEN would preserve. OMEGAMON XE on z/OS V4.2.0 and higher versions: Support KCIJPLOD exclude member support for xKANCLI(KEPEDSDF) Epilog CLIST. KEPEDSF is a CLIST designed to be used in conjunction with automatic EDS maintenance in Epilog. OMEGAMON XE for Mainframe Networks V4.2.0 and higher versions: Enhance xKANSAMU(KN3UAUTH) sample job to provide additional file-tailoring/autodiscovery of the "agentproc", "systemname", and "tcpipprocname" hardcoded variables, so that these variables are file-tailored by default, in the system where the default KN3UAUTH sample is created by the PARMGEN $PARSE* job. This reduces the amount of customization steps required in the "SPECIAL CONSIDERATIONS:" and in the "NOTES:" sections of the JCL comments. A new WCONFIG(KN3$SAUT) imbed is now provided to customers to provide a user-controlled member to customize the contents of the xKANSAMU(KN3UAUTH) job. Note: Running KN3UAUTH is required to define the access for OMEGAMON XE for Mainframe Networks Agent user. ===END "Sub-section: A. 4Q12A RFEs>>B. Application Configuration Enhancements/Updates:" ===END "Sub-section: A. 4Q12A RFEs" ================================================================ ======
Local fix
N/A ================================================================ SYMPTOM: OMEGAMON XE for Messaging started task (CANSMC or CANSMQ) encountered "KLVST004 INVALID RKLVIN PARAMETER - %$IMBED_KMCSTC_KMQPCTL1%, KLVST001 ITM ENGINE INITIALIZATION ERROR(S), ABEND U0012" startup errors in the RKLVLOG in an RTE that configured KMC-only (no KMQ WebSphere MQ Monitoring component), or KMQ-only (no KMC WebSphere MQ Configuration component). DESCRIPTION: If you have configured the OMEGAMON XE for Messaging product and you are configuring only the KMC component only (no KMQ) -or- you are configuring only the KMQ component (no KMC), then PARMGEn incorrectly generates the WKANSAMU started task and WKANPARU(KppSYSIN) runtime members. Here are the list of members incorrectly generated: A. Scenario#1: KMC-only (no KMQ WebSphere MQ Monitoring component) configured in the RTE. xKANSAMU(%KMC_AGT_STC%) KMC started task (CANSMC default) - invalid lines #7 and #208 are generated: VIEW SYS1.PROCLIB(CANSMC) Command ===> Scroll ===> CSR ****** ***************************** Top of Data ****************************** 000001 //************************************************************** **** 000002 //* NAME: CANSMC AGENT ADDRESS SPACE 000003 //* 000004 //* PURPOSE: STARTED TASK PROCEDURE TO RUN AN AGENT ADDRESS SPACE 000005 //* * THIS PROC IS CONFIGURED TO RUN THE FOLLOWING AGENT(S): 000006 //* IBM Tivoli OMEGAMON XE for Messaging - MC Agent 000007 %$IMBED_KMCSTC_MAAS% 000008 //* . . 000206 //RKMCAPLA DD DISP=SHR, 000207 // DSN=&RHILEV..&SYS..RKMCAPLA 000208 %$IMBED_KMCSTC_KMQPCTL1% **************************************************************** *** xKANPARU(KMCSYSIN) - invalid line #10 generated: VIEW IBM.LPAR1.RKANPARU(KMCSYSIN) Command ===> Scroll ===> CSR ****** ***************************** Top of Data ****************************** . 000004 INITIAL(KMCAGST) 000005 OPSTART(KMCOPST) 000006 INITLIST(KMCINIT) 000007 LOADLIST(KRALLIST) 000008 LOADLIST(KCFLLIST) 000009 LOADLIST(KMCLLIST) 000010 %$IMBED_KMCSYSIN_KMQLLIST% **************************************************************** *** -OR- B. Scenario#1: KMQ-only (no KMC WebSphere MQ Configuration component) configured in the RTE. xKANSAMU(%KMQ_AGT_STC%) KMQ started task (CANSMQ default) - invalid lines #43 and #107 are generated: VIEW SYS1.PROCLIB(CANSMQ) Command ===> Scroll ===> CSR ****** ***************************** Top of Data ****************************** 000001 //************************************************************** **** . 000038 //* NAME: CANSMQ AGENT ADDRESS SPACE 000039 //* 000040 //* PURPOSE: STARTED TASK PROCEDURE TO RUN AN AGENT ADDRESS SPACE 000041 //* * THIS PROC IS CONFIGURED TO RUN THE FOLLOWING AGENT(S): 000042 //* IBM Tivoli OMEGAMON XE for Messaging - MQ Agent 000043 %$IMBED_KMQSTC_MAAS% 000044 //* . . 000107 %$IMBED_KMQSTC_RKMCAPLA% **************************************************************** *** xKANPARU(KMQSYSIN) - invalid line #9 generated: VIEW IBM.LPAR1.RKANPARU(KMQSYSIN) Command ===> Scroll ===> CSR ****** ***************************** Top of Data ****************************** . 000004 INITIAL(KMQAGST) 000005 OPSTART(KMQOPST) 000006 INITLIST(KMQINIT) 000007 LOADLIST(KRALLIST) 000008 LOADLIST(KMQLLIST) 000009 %$IMBED_KMQSYSIN_KMCLLIST% *************************************************************** **** WORKAROUND/TIP: : Apply the resolving 4Q12A HKCI310 PTF UA67172 (APAR OA40035) when available. In the interim, manually edit the listed members above to delete the extraneous "%$IMBED_*" lines and save the respective members. If you have applied the resolving PTF, then perform the following enablement steps: Resubmit the WCONFIG(KCIJPUP1) job. Rerun the WCONFIG($PARSE) or WCONFIG($PARSESV) job [if System Variables is enabled]. Rerun the WKANSAMU(KCIJPCPR) backup RK* user libraries job. Rerun the WKANSAMU(KCIJPW2R) WK*->RK* user libraries deployment job to copy the updated KMCSYSIN or KMQSYSIN runtime members. Refresh the OMEGAMON XE for Messaging started task from WKANSAMU to the system procedure library. One may use the PARMGEN-supplied WKANSAMU(KCIJPSYS) system set-up job or manually copy the CANSMC or CANSMQ started task to the system procedure library. ================================================================
Problem summary
**************************************************************** * USERS AFFECTED: All PARMGEN Configuration Tool users. * **************************************************************** * PROBLEM DESCRIPTION: 1. Provide PARMGEN Configuration * * Updates to cover PARMGEN * * Configuration Framework * * Enhancements/Updates applicable * * to all products that support * * PARMGEN mode. * * 2. Provide PARMGEN Workflow UI * * improvements for PARMGEN App. * * Configuration Enhancements/Updates * * - Tivoli Enterprise Monitoring * * Server: * * - Common Agent configuration: * * - Common Persistent Datastore: * * - OMEGAMON Enhanced 3270UI: * * - OMEGAMON XE for CICS on z/OS * * V4.2.0+: * * - OMEGAMON XE for DB2 PE/PM * * V4.2.0+: * * - OMEGAMON XE for IMS on z/OS * * V4.2.0+: * * - OMEGAMON XE on z/OS V4.2.0+: * * - OMEGAMON XE for Mainframe * * Networks V4.2.0+: * **************************************************************** * RECOMMENDATION: Apply the PTF. * **************************************************************** 1. Provide PARMGEN Workflow UI improvements for PARMGEN Configuration Framework Enhancement/Updates: - Implement KOBSUPDT OMEGAMON security standardization of where the KppSUPDI (KOCSUPDI, KO2SUPDI, KOISUPDI, and KOMSUPDI) Classic command tbl. exits can be maintained for user customizations so the composite KCIJPSEC security job can take advantage of using the common RTE_X_SECURITY_EXIT_LIB as the standard user exit library. See master PARMGEN technote FAQ#37 for more information. - Rearchitect the KCIJPW2R WK*->RK* Deployment job by providing support for non-PARMGEN controlled members to be preserved in the RK* user libraries as well as provide a user-controlled list of members that customers can edit to identify other non-configuration-supported runtime members (KLEINPRO for example). KCIJPW2R job is enhanced to preserve any members identified in a new WCONFIG(KCI$XW2R) imbed when the job clears the RK* user libraries prior to copying the refreshed WK* runtime members. 2. Provide PARMGEN Workflow UI improvements for PARMGEN Application Configuration Enhancements/Updates: - All standalone agents: * Updated WCONFIG(Kpp$*): Override Imbeds that need to be renamed so KCIJPUP1 job automatically rebuilds a new default Kpp$P* override member. - WCONFIG(KAG$PENV): Changes: Sample Agent Autonomy-related placeholder (commented out) parameters are now provided as a reference if customer would like to exploit the different agent features. - Tivoli Enterprise Monitoring Server (TEMS) and OMEGAMON Enhanced 3270 UI: * Support "KDS_X_TEMS_KDSSTRT1_DELAY_INT" parameter to control the interval when the TEMS issues the Agent startup commands, including the OMEGAMON Enhanced 3270 Data Retrieval Agent (DRA) included in the xKANCMDU(KDSSTRT1) member. - Common Agent configuration: * Provide sample Agent Autonomy-related default parameters as placeholders in the WCONFIG(KAG$PENV) common Agent xKANPARU(KppENV) standalone Agent environment member. Please refer to the IBM Tivoli Monitoring Administrator's Guide for more information if you wish to exploit these features. - Common Persistent Datastore: * Default the Persistent Datastore related SMS parameters with the global RTE SMS-related VOLUME, UNIT, STORCLAS, and MGMTCLAS automatically. - OMEGAMON XE for CICS on z/OS V4.2.0 and higher versions: * Increase the PARMGEN KCIJPALO allocation/ initialization support for task history VSAM libraries (&rvhilev.&rte.%KC2_HSnn_CLASSIC_CICS_REGION%.RKC2HIST) for CICS regions greater than 99 CICS regions. - OMEGAMON XE for DB2 PE/PM V4.2.0 and higher versions: * Allocate the TMPD2* DDNAMEs for temporary datasets in the CANSO2 & CANSD2 started tasks with a SPACE() allocations large enough to accommodate resolving the runtime members for > 45 DB2 subsystems. - OMEGAMON XE for DB2 PE/PM V4.2.0 and higher versions: * Provide System Variables support for xKD2SAM(FPEJINIT) sample REXX program to Invoke OMEGAMON XE for DB2 PE on z/OS ISPF Application. - OMEGAMON XE on IMS V4.2.0 and V5.1.0: * Enhance xKANPARU(KOIJLF00) Journal Logging Facility (JLF) startup member to provide full-tailoring capabilities so customers are able to fully-customize the different JLF startup options that PARMGEN would preserve. - OMEGAMON XE on z/OS V4.2.0 and V5.1.0: * Support KCIJPLOD exclude member support for xKANCLI(KEPEDSDF) Epilog CLIST. KEPEDSF is a CLIST desgined to be used in conjunction with automatic EDS maintenance in Epilog. - OMEGAMON XE for Mainframe Networks V4.2.0: * Enhance xKANSAMU(KN3UAUTH) sample job to provide additional file-tailoring/autodiscovery of the "agentproc", "systemname", and "tcpipprocname" hardcoded variables, so that these variables are file-tailored by default, in the system where the default KN3UAUTH sample is created by the PARMGEN $PARSE* job. This reduces the amount of customization steps required in the "SPECIAL CONSIDERATIONS:" and in the "NOTES:" sections of the JCL comments. A new WCONFIG(KN3$SAUT) imbed is now provided to customers to provide a user-controlled member to customize the contents of the xKANSAMU(KN3UAUTH) job. Note: Running KN3UAUTH is required to define the access for OMEGAMON XE for Mainframe Networks Agent user.
Problem conclusion
Temporary fix
Comments
This PTF has a HOLDDATA for ACTION if you are a PARMGEN user. This PTF introduces new/modified/deleted PARMGEN templates and jobs that affect existing PARMGEN RTE WCONFIG library set-up and WK* work library members in the RTE. The goal of these updates is to make the PARMGEN RTE workflow process much easier to configure, deploy and maintain. Please refer to Newflash Technote #1417935 "PARMGEN Alternative Configuration for OMEGAMON XE and Tivoli Management Services (TMS) Products on z/OS" URL: http://www-01.ibm.com/support/docview.wss?uid=swg21417935 for more information. Specifically, the "What's New" section ("4Q12A" sub-section) of this technote outlines the deltas and required actions for existing PARMGEN-created RTEs.
APAR Information
APAR number
OA40035
Reported component name
CICAT CONFIG SE
Reported component ID
5608A41CC
Reported release
310
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / Installability / Serviceability /
Xsystem
Submitted date
2012-07-25
Closed date
2012-11-09
Last modified date
2013-02-05
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UA67172
Modules/Macros
KCIPRMLB KC5PRMLB KDSPRMLB KD5PRMLB KM5PRMLB
Fix information
Fixed component name
CICAT CONFIG SE
Fixed component ID
5608A41CC
Applicable component levels
R310 PSY UA67172
UP12/12/27 P F212
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSRLR8","label":"Tivoli Components"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"310","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
05 February 2013