IBM Support

OA43392: CI310 PARMGEN CONFIGURATION ENHANCEMENTS FOR OMEGAMON XE FOR DB2 PE/PM

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • PROBLEM DESC:
    RFE: Provide PARMGEN Workflow UI improvements for:
      A. PARMGEN Configuration Framework Enhancements/Updates:
      1. Specify the level of checking that the
         WCONFIG(KCIJPVAL) validation job or the VALIDATE step
         of the WCONFIG($PARSE*) job will perform.  Review the
         WCONFIG($VALRPT) validation report Section 1 and
         Section 4 for any flagged errors. Valid values are:
         o - I (Informational) is the least restrictive level
             which results in the KCIJPVAL and $PARSE jobs
             return a RC=0, allowing the jobs  to proceed even
             if there are flagged parameters in Section 1 or
             Section 4 of the $VALRPT validation report.
         o - W (Warning) is less restrictive where KCIJPVAL and
             $PARSE will return RC=4 but $PARSE will still run
             and configure all the products. This is basically
             the toleration mode level.
         o - E (Error) is the most restrictive validation level.
             Each invalid value will be reported as an error and
             therefore would hold further KCIJPVAL or $PARSE
             processing.
         The default is W (Warning) validation level. *Benefit:
         For staged upgrades, when the products that exploit
         PARMGEN provide product-specific validation exits, a
         customer may override the level of validation checking
         especially when a new version no longer supports an
         older release or version of a supported subsystem at
         earlier versions of a product.
      B. PARMGEN Application Configuration Enhancements/Updates:
      1. Tivoli Enterprise Monitoring Server (TEMS): Modify
         "KDS_TEMS_COMM_PROTOCOLn" TEMS
         PROTOCOL1/PROTOCOL2/PROTOCOL3 protocol-related
         parameter defaults from "IPPIPE", "IP" ,"SNA" to
         "IPPIPE", "SNA".  ¢Benefit:  IPPIPE is the recommended
         IP-related protocol to enable by default, rather than
         IPPIPE and UDP ("IP") for a z/OS-based TEMS.
      2. Common Agent configuration: Modify
         "Kpp_AGT_COMM_PROTOCOLn" PROTOCOL1/PROTOCOL2/PROTOCOL3
         protocol-related parameter defaults from "IPPIPE", "IP"
         ,"SNA"  to "IPPIPE", "SNA".  ¢Benefit: IPPIPE is the
         recommended IP-related protocol to enable by default,
         rather than IPPIPE and UDP ("IP") for z/OS-based
         Agents.
      3. OMEGAMON XE for DB2 PE/PM V5.2.0:
         "GBL_DSN_DB2_LOADLIB_V11 and GBL_DSN_DB2_RUNLIB_V11" -
         for OMEGAMON XE for DB2 PE/PM V5.2.0's DB2 V11 support,
         these two new parameters are now supported in the
         WCONFIG($GBL*) global profile.
    
    SPECIAL CONDITIONS:
    
      ACTION: ** Applicable to PARMGEN Configuration Mode Users Only
    **
              HKCI310 PTF UAXXXXX delivers new functions and updates
    for
              A. PARMGEN Configuration Framework
              B. PARMGEN Application Configuration
    
              HKCI310 PTF UAXXXXX (4Q13A) supercedes the following
    PTFs:
              - HKCI310 PTF UA70760 (3Q13A Interim Feature (IF))
              - HKCI310 PTF UA69076 (2Q13A Interim Feature (IF))
              - HKCI310 PTF UA67787 (1Q13A Interim Feature (IF))
              - HKCI310 PTF UA67172 (4Q12A IF)
              - HKCI310 PTF UA66332 (3Q12B IF)
              - HKCI310 PTFs UA65847, UA66106 and UA66338 (3Q12A IF)
              - HKCI310 PTF UA64407 (2Q12B IF)
              - HKCI310 PTF UA65042 (2Q12A IF)
    
              For PARMGEN-related configuration updates (A. and B.),
              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 Configuration for OMEGAMON XE and
              Tivoli Management Services (TMS) Products on z/OS"
    URL:
              http://www.ibm.com/support/docview.wss?uid=swg21417935
              for more information.  Specifically, the "What's New"
              section ("4Q13A" sub-section) of this technote
    outlines
              the deltas and required actions for existing
              PARMGEN-created RTEs.
      DEPENDENCY: ** Applicable to PARMGEN Mode Users Only **
    
        NOTES- Please review the "What's New" section (4Q13A) in the
               master PARMGEN technote.
               HKCI310 PTF UAXXXXX delivers new functions and
    updates
               in support of the new OMEGAMON XE for DB2 PE/PM
    V5.2.0
               version.
               For planning purposes, if you plan to install the new
               OMEGAMON XE for DB2 PE/PM V5.2.0 version, you must
    also
               install the HKDB520 PTFs associated with these OMXE
    DB2
               APARs prior to starting the ICAT-to-PARMGEN
    conversion
               configuration work or the PARMGEN configuration:
               - PM97298
               - PM97296
               - PM97294
               Tip: Subscribe:
               http://www.ibm.com/support/electronicsupport/
               Sign-up for IBM MyNotifications:
               https://www.ibm.com/support/mynotifications
        INSTR- Please read the "What's New" section (4Q13A
    deliverables)
               of the master PARMGEN technote, which outlines the
    deltas
               and required actions for PARMGEN-created RTEs.
               You must install the HKDB520 PTFs associated with the
               PM9729* OMEGAMON XE for DB2 PE/PM APARs prior to any
               ICAT Batch or PARMGEN configuration work.
    

Local fix

  • N/A
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All PARMGEN Configuration Users.             *
    ****************************************************************
    * PROBLEM DESCRIPTION: A. PARMGEN Configuration Framework      *
    *                      Enhancements/Updates:                   *
    *                      1. Specify the level of checking        *
    *                         that the WCONFIG(KCIJPVAL)           *
    *                         validation job or the VALIDATE       *
    *                         step of the WCONFIG($PARSE*) job     *
    *                         will perform.  Review the            *
    *                         WCONFIG($VALRPT) validation          *
    *                         report Section 1 and Section 4       *
    *                         for any flagged errors. Valid        *
    *                         values are:                          *
    *                      o - I (Informational) is the            *
    *                          least restrictive level             *
    *                          which results in the                *
    *                          KCIJPVAL and $PARSE jobs            *
    *                          return a RC=0, allowing the         *
    *                          jobs  to proceed even if            *
    *                          there are flagged parameters        *
    *                          in Section 1 or Section 4 of        *
    *                          the $VALRPT validation report.      *
    *                      o - W (Warning) is less                 *
    *                          restrictive where KCIJPVAL          *
    *                          and $PARSE will return RC=4         *
    *                          but $PARSE will still run           *
    *                          and configure all the               *
    *                          products. This is basically         *
    *                          the toleration mode level.          *
    *                      o - E (Error) is the most               *
    *                          restrictive validation              *
    *                          level.  Each invalid value          *
    *                          will be reported as an error        *
    *                          and therefore would hold            *
    *                          further KCIJPVAL or $PARSE          *
    *                          processing.                         *
    *                         The default is W (Warning)           *
    *                         validation level. *Benefit:  For     *
    *                         staged upgrades, when the products   *
    *                         that exploit PARMGEN provide         *
    *                         product-specific validation exits,   *
    *                         a customer may override the level    *
    *                         validation checking especially when  *
    *                         a new version no longer supports an  *
    *                         older release or version of a        *
    *                         supported subsystem at earlier       *
    *                         versions of a product.               *
    *                                                              *
    *                                                              *
    *                      B. PARMGEN Application Configuration    *
    *                      Enhancements/Updates:                   *
    *                      1. Tivoli Enterprise Monitoring Server  *
    *                         (TEMS): Modify                       *
    *                         "KDS_TEMS_COMM_PROTOCOLn" TEMS       *
    *                         PROTOCOL1/PROTOCOL2/PROTOCOL3        *
    *                         protocol-related parameter defaults  *
    *                         from "IPPIPE", "IP" ,"SNA" to        *
    *                         "IPPIPE", "SNA".  ¢Benefit:  IPPIPE  *
    *                         is the recommended IP-related        *
    *                         protocol to enable by default, than  *
    *                         than IPPIPE and UDP ("IP") for a     *
    *                         z/OS-based TEMS.                     *
    *                      2. Common Agent configuration: Modify   *
    *                         "Kpp_AGT_COMM_PROTOCOLn"             *
    *                         PROTOCOL1/PROTOCOL2/PROTOCOL3        *
    *                         protocol-related parameter defaults  *
    *                         from "IPPIPE", "IP" ,"SNA"  to       *
    *                         "IPPIPE", "SNA".  ¢Benefit: IPPIPE   *
    *                         is the recommended IP-related        *
    *                         protocol to enable by default,       *
    *                         rather than IPPIPE and UDP ("IP")    *
    *                         for z/OS-based Agents.               *
    *                      3. OMEGAMON XE for DB2 PE/PM V5.2.0:    *
    *                         "GBL_DSN_DB2_LOADLIB_V11 and         *
    *                         GBL_DSN_DB2_RUNLIB_V11" - for        *
    *                         OMEGAMON XE for DB2 PE/PM V5.2.0's   *
    *                         DB2 V11 support, these two new       *
    *                         parameters are now supported in the  *
    *                         WCONFIG($GBL*) global profile.       *
    *                                                              *
    *                                                              *
    *                                                              *
    ****************************************************************
    * RECOMMENDATION: Apply the PTF.                               *
    Provide OMEGAMON XE for DB2 PE/PM related KCICRPLC enhancements.
    

Problem conclusion

Temporary fix

Comments

  • 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 Application Configuration Enhancements/Updates:   -
    Tivoli Enterprise Monitoring Server:                    - Common
    Agent configuration:                             - OMEGAMON XE
    for DB2 PE/PM V5.2.0:
    

APAR Information

  • APAR number

    OA43392

  • Reported component name

    PARMGEN ICAT CO

  • Reported component ID

    5608A41CC

  • Reported release

    310

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / Xsystem

  • Submitted date

    2013-09-18

  • Closed date

    2013-10-13

  • Last modified date

    2013-11-04

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    UA71054

Modules/Macros

  • KD5PRMLB
    

Fix information

  • Fixed component name

    PARMGEN ICAT CO

  • Fixed component ID

    5608A41CC

Applicable component levels

  • R310 PSY UA71054

       UP13/10/24 P F310

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:
04 November 2013