OA41710: CI310 PARMGEN AND ICAT INFRASTRUCTURE CONFIGURATION UPDATES - 2Q13A INTERIM FEATURE (IF)

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as new function.

Error description

  • The following enhancements and issues will be addressed in the
    HKCI310 PARMGEN PTF UAxxxxx for APAR OA41710:
    A.  2Q13A Enhancements:
    
    RFE: Provide PARMGEN Workflow UI improvements for:
    A. PARMGEN Configuration Framework Enhancements/Updates:
    Provide additional fields to the KCIP@PG3 "SET UP PARMGEN WORK
    ENVIRONMENT FOR AN RTE (3 OF 3)" panel such as:
    "RTE_LOAD_SHARED_LIBS" (for a sharing RTE (RTE_TYPE=SHARE), this
    parameter provides the option to include the read-only shared
    runtime datasets to be loaded in the WKANSAMU(KCIJPLOD) RTE Load
    job) and "RTE_TCP_PORT_NUM" (IP-related port number used for
    TEMS and Agent connectivity).  Benefit: For first-time users,
    one has less parameters to customize in the initial LPAR profile
    as these field values are used to initialize the LPAR profile
    out of the box.  If you have all the products configured, adding
    these 2 additional global RTE fields on the KCIP@PG3 panel saves
    customers 49 total parameters from customizing.
    Provide KMS_SECURITY_COMPATIBILITY_MODE z/OS ITM6.3.0 command
    request security enhancements for a standalone Agent
    configuration by supporting ICSF load library concatenation in
    any standalone Agent's started task's (Kpp_AGT_STC PARMGEN LPAR
    profile parameter) RKANMODL DDNAME.  In addition, enhance the
    common Agent configuration to allow an Agent-only RTE to
    customize the TMS:Engine password encryption key
    (RKANPARU(KAES256)) and provide a standalone KAES256 encryption
    job (RKANSAMU(KDSDKAES)) for an Agent-only RTE.  Two PARMGEN
    profile parameters provide support for the ITM6.3.0 Take Action
    KMS_SECURITY_COMPATIBILITY_MODE security enhancements --
    existing "GBL_DSN_CSF_SCSFMOD0" parameter in the
    WCONFIG($GBL$USR), which is now extended to all Agent
    configuration, and new "RTE_SECURITY_KAES256_KEY" parameter in
    the WCONFIG(%RTE_NAME%) LPAR profile.
    Support a new RTE_USS_MKDIR_MODE parameter for customizing the
    access mode to be used in the PARMGEN USS-related jobs
    (KCIJPUSP/KCIJPUSS) so when KCIJPUSP creates the RTE
    RKANDATV(KDSRMKDB) TEMS Self-Describing Agent (SDA) member that
    contains the SDA USS RTEDIR mkdir commands, the MODE() is
    customized to site's security audit requirements.   Benefit:
    Allow flexibility of specifying customer's site-required USS
    make directory (mkdir) commands' permissions/access mode that
    meet audit requirements.
    Provide a new WKANSAMU(KCIJPMTY) job to perform the
    EMPT*-related steps only, of the KCIJPW%R WK*->RK* deployment
    job.  Benefit: Moving the EMPT* steps out of the standard
    KCIJPW2R WK*->RK* deployment job allows for the IEBCOPY jobs to
    run without requiring the started tasks to be recycled.  The
    emptying of  the RK* user libraries ensures that there are no
    obsolete members in the RK* user libraries in the event that
    runtime members are no longer used (product is no longer
    configured in the RTE or the runtime member is now obsolete, or
    if a configuration option changed and the runtime member name is
    dependent on the configuration option like subsystem names or
    IDs).
    Support WKANSAMU(KCIJPW1R), a new job name for KCIJPW2R job.
    Re-architectured KCIJPW2R job no longer has the EMPT* steps.
    Instead, KCIJPW1R job is now performing what the original
    KCIJPW2R job used to do.   Benefit: Moving the EMPT* steps out
    of the standard KCIJPW2R WK*->RK* deployment job into a new
    KCIJPW1R name allows the flexibility for customer to choose
    which deployment job to run. Repurposed KCIJPW2R job without the
    EMPT* steps in the deployment job allows for the IEBCOPY jobs to
    run without requiring the started tasks to be recycled.
    Support WKANSAMU(KCIJPSPC), a new job to compare (SUPERC) the
    runtime members from the PARMGEN WK* (WKANCMDU, WKANPARU,
    WKANSAMU, WKD2PAR, WKD2PRF, WKD2SAM) work libraries from the
    product execution RK*  (RKANCMDU, RKANPARU, RKANSAMU, RKD2PAR,
    RKD2PRF, RKD2SAM) user libraries prior to running the KCIJPW2R
    WK*->RK* deployment job.  The job also provides a resulting
    output WSUPERC SYSTSPRT report, which is stored in the WSUPERC
    sequential library.  Benefit: Provide a handy utility job that
    allows customers to see the deltas of what PARMGEN created in
    the WK* libraries versus what is running in the product
    execution libraries prior to deploying the runtime members.
    Enhance the WCONFIG($PARSEDV) standalone System Variables
    resolution report job.  The $PARSEDV WCONFIG($SYSVAR1) report
    has been enhanced to now include the listing for the
    user-defined symbols and their resolved values.  $PARSEDV is a
    standalone job that can be run to get a list of resolved values
    for symbolics used in this RTE.  It writes out the $SYSVAR1
    report in the WCONFIG library.  The $SYSVAR1 report provides the
    listing of three types of system variables autodiscovered by the
    PARMGEN process: - Type 1: Static system symbols, - Type 2:
    PARMGEN KCIPARSE-extracted symbols.  PARMGEN provides support
    for user-defined symbols also: - Type 3: User-defined symbols
    (available in other $PARSE* jobs' SYSVROUT DD also).  Benefit:
    $PARSEDV $SYSVAR1 output can be reused as the System Variables
    GBL_USER_JCL(%RTE_NAME%) System Variables resolution member
    model out-of-the-box.
    Enhance the WKANSAMU(&ppp_*_STC) product started task KCIPARSE
    reporting options.  The KCIPARSE step generated in product
    started tasks in System Variables-enabled RTEs
    (RTE_SYSV_SYSVAR_FLAG=Y) exposes a LIST=YES parameter in the
    KCIPRM() internal KCIPARSE parameters.  LIST=YES is one of the
    KCIPARSE program's "CONTROL VALUES IN EFFECT" options to display
    the report in the SYSPRINT DDNAME of the running started task.
    The report contains the resolution values of the runtime members
    processed as generated in the detailed "INPUT PDS MEMBER
    SUMMARY" report.   Benefit:  Writing out the LIST=YES option by
    default allows customers the flexibility to set to LIST=NO if
    they want to suppress this report from the started task log.
    ===END "Sub-section: A. 2Q13A RFEs>>A. Configuration Framework
    Enhancements/Updates:"
    
    B. PARMGEN-supported Application Configuration
    Enhancements/Updates:
    Tivoli Enterprise Monitoring Server (TEMS) V6.3.0 only: Support
    "KDS_KMS_SECURITY_COMPATMD" proflle parameter to allow customiza
    of the KMS_SECURITY_COMPATIBILITY_MODE=%KDS_KMS_SECURITY_COMPATM
    parameter in the RTE's RKANPARU(KDSENV) member.   Benefit: Provi
    the flexibility to customize and preserve customer-defined value
    for the KMS_SECURITY_COMPATIBILITY_MODE parameter in the RTE's x
    member.
    

Local fix

  • 2Q13A Issues:
    
    SYMPTOM:  The OMEGAMON XE on z/OS LPAR-specific short-term
    history Persistent Datastore files (&rhilev.&rte.RKM5LPRn) is
    always allocated as SIZE=7M per dataset regardless what
    KM5_PD_CYL parameter is set to.
    
    SYMPTOM:  The OMEGAMON XE for DB2 PE/PM KDPCNFG collector syntax
    generates "KDPDC08E INVALID SUBSYSTEM TYPE='E2ESECURE'" error
    message in the RKLVLOG.
    WORKAROUND: See PARMGEN technote "2Q13A Issues" for more
    information ()
    https://www-304.ibm.com/support/docview.wss?uid=swg21417935
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All z/OS Configuration tool and PARMGEN      *
    *                 users.                                       *
    ****************************************************************
    * PROBLEM DESCRIPTION: Section: 2Q13A Request for Enhancements *
    *                      (RFE)/Issues Addressed by APAR OAxxxxx  *
    *                      (HKCI310 PTF UAxxxxx):  The following   *
    *                      enhancements and issues will be         *
    *                      addressed in the HKCI310 PARMGEN PTF    *
    *                      UAxxxxx for APAR OAxxxxx: A.  2Q13A     *
    *                      Enhancements:                           *
    *                      ======================================= *
    *                      ========================= A. PARMGEN    *
    *                      Configuration Framework                 *
    *                      Enhancements/Updates: 1. Provide        *
    *                      KMS_SECURITY_COMPATIBILITY_MODE z/OS    *
    *                      ITM6.3 Take Action security             *
    *                      enhancements for a standalone Agent     *
    *                      configuration by supporting ICSF load   *
    *                      library concatenation in any standalone *
    *                      Agent's started task's (Kpp_AGT_STC     *
    *                      PARMGEN LPAR profile parameter)         *
    *                      RKANMODL DDNAME.  In addition, enhance  *
    *                      the common Agent configuration to allow *
    *                      an Agent-only RTE to customize the      *
    *                      TMS:Engine password encryption key      *
    *                      (RKANPARU(KAES256)) and provide a       *
    *                      standalone KAES256 encryption job       *
    *                      (RKANSAMU(KDSDKAES)) for an Agent-only  *
    *                      RTE.  Two PARMGEN profile parameters    *
    *                      provide support for the ITM6.3 Take     *
    *                      Action KMS_SECURITY_COMPATIBILITY_MODE  *
    *                      security enhancements -- existing       *
    *                      "GBL_DSN_CSF_SCSFMOD0" parameter in the *
    *                      WCONFIG($GBL$USR), which is now         *
    *                      extended to all Agent configuration,    *
    *                      and new "RTE_SECURITY_KAES256_ENCKEY"   *
    *                      parameter in the WCONFIG(%RTE_NAME%)    *
    *                      LPAR profile. ===END "Sub-section: A.   *
    *                      2Q13A RFEs>>A. Configuration Framework  *
    *                      Enhancements/Updates:" 2. <Placeholder> *
    *                      B. PARMGEN-supported Application        *
    *                      Configuration Enhancements/Updates: 1.  *
    *                      Tivoli Enterprise Monitoring Server     *
    *                      (TEMS): <Placeholder>. >Benefit:        *
    *                      <Placeholder> 2. Common Agent           *
    *                      configuration: Provide                  *
    *                      KMS_SECURITY_COMPATIBILITY_MODE z/OS    *
    *                      ITM6.3 Take Action security             *
    *                      enhancements for a standalone Agent     *
    *                      configuration by supporting ICSF load   *
    *                      library concatenation in any standalone *
    *                      Agent's started task's (Kpp_AGT_STC     *
    *                      PARMGEN LPAR profile parameter)         *
    *                      RKANMODL DDNAME.  In addition, enhance  *
    *                      the common Agent configuration to allow *
    *                      an Agent-only RTE to customize the      *
    *                      TMS:Engine password encryption key      *
    *                      (RKANPARU(KAES256) and provide a        *
    *                      standalone KAES256 encryption job       *
    *                      (RKANSAMU(KDSDKAES) for an Agent-only   *
    *                      RTE. 3. OMEGAMON XE for DB2 PE/PM       *
    *                      V5.1.0 and higher versions: Increase    *
    *                      the KD5_X_AGT_STORAGE_LIMIT_EXTEND      *
    *                      configuration default from 22 to 24 in  *
    *                      order to generate LIMIT(24,X) in the    *
    *                      KD5SYSIN member in the RTE's            *
    *                      WKANPARU/RKANPARU library. 4. ITCAM for *
    *                      Application Diagnostics V7.1.0: Provide *
    *                      KWJ_VERS=07.10.03 support in the z/OS   *
    *                      KYN Agent's xKANPARU(KYNENV) member.    *
    *                      Currently, the KWJ_VERS is displayed on *
    *                      TEPS in 'Managed System Status' screen  *
    *                      in Version column.  On z/OS, the        *
    *                      KWJ_VERS is generated in the RTE's      *
    *                      xKANPARU(KYNENV) runtime member.        *
    *                      >Benefit: For ease of use, KWJ_VERS     *
    *                      quickly identifies the versions of all  *
    *                      connected KYN TEMAs to further aid in   *
    *                      problem determination. ===END           *
    *                      "Sub-section: A. 2Q13A RFEs>>B.         *
    *                      Application Configuration               *
    *                      Enhancements/Updates:"                  *
    ****************************************************************
    * RECOMMENDATION: Apply the PTF.                               *
    Section: 2Q13A Request for Enhancements (RFE)/Issues Addressed
    by APAR OAxxxxx (HKCI310 PTF UAxxxxx):  The following
    enhancements and issues will be addressed in the HKCI310 PARMGEN
    PTF UAxxxxx for APAR OAxxxxx: A.  2Q13A Enhancements:
    ================================================================
    A. PARMGEN Configuration Framework Enhancements/Updates: 1.
    Provide KMS_SECURITY_COMPATIBILITY_MODE z/OS ITM6.3 Take Action
    security enhancements for a standalone Agent configuration by
    supporting ICSF load library concatenation in any standalone
    Agent's started task's (Kpp_AGT_STC PARMGEN LPAR profile
    parameter) RKANMODL DDNAME.  In addition, enhance the common
    Agent configuration to allow an Agent-only RTE to customize the
    TMS:Engine password encryption key (RKANPARU(KAES256)) and
    provide a standalone KAES256 encryption job (RKANSAMU(KDSDKAES))
    for an Agent-only RTE.  Two PARMGEN profile parameters provide
    support for the ITM6.3 Take Action
    KMS_SECURITY_COMPATIBILITY_MODE security enhancements --
    existing "GBL_DSN_CSF_SCSFMOD0" parameter in the
    WCONFIG($GBL$USR), which is now extended to all Agent
    configuration, and new "RTE_SECURITY_KAES256_ENCKEY" parameter
    in the WCONFIG(%RTE_NAME%) LPAR profile. ===END "Sub-section: A.
    2Q13A RFEs>>A. Configuration Framework Enhancements/Updates:" 2.
    <Placeholder>  B. PARMGEN-supported Application Configuration
    Enhancements/Updates: 1. Tivoli Enterprise Monitoring Server
    (TEMS): <Placeholder>. >Benefit: <Placeholder> 2. Common Agent
    configuration: Provide KMS_SECURITY_COMPATIBILITY_MODE z/OS
    ITM6.3 Take Action security enhancements for a standalone Agent
    configuration by supporting ICSF load library concatenation in
    any standalone Agent's started task's (Kpp_AGT_STC PARMGEN LPAR
    profile parameter) RKANMODL DDNAME.  In addition, enhance the
    common Agent configuration to allow an Agent-only RTE to
    customize the TMS:Engine password encryption key
    (RKANPARU(KAES256) and provide a standalone KAES256 encryption
    job (RKANSAMU(KDSDKAES) for an Agent-only RTE. 3. OMEGAMON XE
    for DB2 PE/PM V5.1.0 and higher versions: Increase the
    KD5_X_AGT_STORAGE_LIMIT_EXTEND configuration default from 22 to
    24 in order to generate LIMIT(24,X) in the KD5SYSIN member in
    the RTE's WKANPARU/RKANPARU library. 4. ITCAM for Application
    Diagnostics V7.1.0: Provide KWJ_VERS=07.10.03 support in the
    z/OS KYN Agent's xKANPARU(KYNENV) member.  Currently, the
    KWJ_VERS is displayed on TEPS in 'Managed System Status' screen
    in Version column.  On z/OS, the KWJ_VERS is generated in the
    RTE's xKANPARU(KYNENV) runtime member. >Benefit: For ease of
    use, KWJ_VERS quickly identifies the versions of all connected
    KYN TEMAs to further aid in problem determination. ===END
    "Sub-section: A. 2Q13A RFEs>>B. Application Configuration
    Enhancements/Updates:"
    

Problem conclusion

Temporary fix

Comments

  • For PARMGEN-related configuration updates,               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-01.ibm.com/support/docview.wss?uid=swg21417935for
    more information.  Specifically, the "What's New"    section
    ("2Q13A" sub-section) of this technote outlines  the deltas and
    required actions for existing             PARMGEN-created RTEs.
    

APAR Information

  • APAR number

    OA41710

  • 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

  • Submitted date

    2013-03-19

  • Closed date

    2013-05-09

  • Last modified date

    2013-07-02

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

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

    UA69076

Modules/Macros

  •    KCIPRMLB KDSPRMLB
    

Fix information

  • Fixed component name

    PARMGEN ICAT CO

  • Fixed component ID

    5608A41CC

Applicable component levels

  • R310 PSY UA69076

       UP13/06/29 P F306

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

Add comments

Document information


More support for:

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

Software version:

310

Reference #:

OA41710

Modified date:

2013-07-02

Translate my page

Machine Translation

Content navigation