OA40035: CI310 JOBGEN, PARMGEN, AND ICAT FRAMEWORK UPDATES

A fix is available

Subscribe

You can track all active APARs for this component.

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

  • 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.



Rate this page:

(0 users)Average rating

Document information


More support for:

Tivoli Components
IBM Tivoli OMEGAMON Installation Configuration Assistance Tool (CICAT)

Software version:

310

Reference #:

OA40035

Modified date:

2013-02-05

Translate my page

Machine Translation

Content navigation