IBM Support

PH06650: CICS RELEASE VALUE NOT SET WHEN POLICY RULE IS INSTALLED.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • CICS Release value not set when Policy Rule is installed
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of CICSPlex SM V5R1M0, V5R2M0,     *
    *                 V5R3M0, V5R4M0 and V5R5M0.                   *
    ****************************************************************
    * PROBLEM DESCRIPTION: While using the CICS Explorer to        *
    *                      access the "Policy Rules (CICS)"        *
    *                      view:                                   *
    *                                                              *
    *                      - CICS policies are displayed with      *
    *                      the "CICS Release" field set to         *
    *                      blanks.                                 *
    *                                                              *
    *                      - On using the "Aggregate Records"      *
    *                      button, to request record               *
    *                      aggregation the following errors        *
    *                      appear:                                 *
    *                                                              *
    *                      CNX0624E: Get Policy Rule from          *
    *                      "xxxxxxx" failed.                       *
    *                                                              *
    *                      CNX0595E: An unexpected failure         *
    *                      occurred: Exception while fetching      *
    *                      data                                    *
    *                      (/cicsplex/cicsResources/rule):         *
    *                      java.lang.IllegalArgumentException:     *
    *                      No enum constant                        *
    *                      com.ibm.cics.drake.model.               *
    *                      CICSRelease.                            *
    *                                                              *
    *                      When using the CICS Explorer,           *
    *                      multiple inconsistencies are            *
    *                      identified between Policy Rule          *
    *                      records where the Policy rule is for    *
    *                      a system rule.                          *
    ****************************************************************
    * RECOMMENDATION: After applying the PTF that resolves APAR    *
    *                 PH06650, all CMASes, MASes and WUI regions   *
    *                 must be restarted.  Note that the restarts   *
    *                 do not need to occur at the same time.       *
    ****************************************************************
    Requests for the CICSPlex SM API RULE resource table, were
    directed to all MAS regions within the API CONTEXT and SCOPE.
    However, module EYU0NQPU which is  responsible for mapping the
    records that should be returned to the API used the wrong data
    structure so the field containing the CICS release could not be
    returned.
    
    While using the CICS Explorer, the following inconsistencies
    are identified between Policy Rule records, where the Policy
    Rule is for a system rule:
    
    - The "Specified Threshold Value" (RULE_VALUE field) is
    displayed in the CICS Explorer as "4,294,967,295" when a MAS
    uses CPSM libraries prior to CICS TS V5.5. When the MAS CPSM
    libraries are at CICS TS V5.5, the CICS Explorer will return
    "N/A".
    
    - The "Specified Threshold Value" (RULE_VALUE) field is
    displayed in the CICS Explorer as "?" when the CICS Explorer
    is connected to a WUI with CPSM libraries prior to CICS TS
    V5.5 and inquiring on Policy rule records for system rules,
    from MAS regions with CPSM libraries at CICS TS V5.5. When the
    WUI CPSM libraries are at CICS TS V5.5, the CICS Explorer will
    return "N/A".
    
    - The "Actual Threshold Value" (RULE_THRESHOLD) field
    is displayed in the CICS Explorer as "?" when the CICS
    Explorer is connected to a WUI with CPSM libraries prior to
    CICS TS V5.5. When the WUI CPSM libraries are at CICS TS V5.5,
    the CICS Explorer will return "N/A".
    
    - The "Value Units" (RULE_UNITS field) is displayed
    as "NONE" when a MAS uses CICS libraries prior to CICS TS
    V5.5. When the MAS' CICS libraries are at CICS TS V5.5, the
    CICS Explorer will return "NOTAPPLIC.
    
    - The "Operator" (RULE_OPERATOR field) is displayed
    as "NONE" when a MAS uses CICS libraries prior to CICS TS
    V5.5. When the MAS' CICS libraries are at CICS TS V5.5, the
    CICS Explorer will return "NOTAPPLIC.
    
    Additionally, CPSM module EYU0NPQU NQPU directly calls CICS MP
    domain gate MPIB to browse CICS policy rules and does not
    correctly translate the RULE_VALUE field returned back to it
    from MPIB.
    Prior to CICS TS V5.5, MPIB returned a value equivalent to
    NONE" for the policy rule operator and units. At CICS TS V5.5,
    this was updated to return a value equivalent to "NOTAPPLIC".
    

Problem conclusion

  • CICS domain gate MPIB has been updated to return NOTAPPLIC
    values for OPERATOR and UNIT fields.
    
    Module EYU0NQPU has been updated to:
    - Use the correct mapping structure for the queue header
    allowing for the CICS release to be returned back to the CPSM
    API.
    
    - Correctly translate the VALUE field returned by CICS domain
    gate MPIB and return this in the RULE_VALUE field.
    
    - Add translations for the MPIB UNIT and OPERATOR fields to
    account for the new NOTAPPLIC value.
    
    CICSPlex SM RULE resource table has been updated to:
    - Change the VALUE and THRESHOLD fields to Coded Numeric
    (CNUMERIC) data types.
    
    - Improve field level help and descriptions.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH06650

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    80M

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-12-19

  • Closed date

    2019-03-20

  • Last modified date

    2019-04-02

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

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

    UI62010 UI62011 UI62012 UI62013 UI62014 UI62015 UI62016 UI62017
    UI62018

Modules/Macros

  • CJE0NQPU CJF0NQPU CJG0NQPU CJH0NQPU DFHMPIB  DFHMPIBT EYU0NQPU
    EYUA0215 EYUC0215 EYUL0215 EYUP0215 EYUT0215 EYUY0215
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R000 PSY UI62017

       UP19/03/21 P F903

  • R00M PSY UI62018

       UP19/03/21 P F903

  • R100 PSY UI62014

       UP19/03/21 P F903

  • R10M PSY UI62015

       UP19/03/21 P F903

  • R20M PSY UI62016

       UP19/03/21 P F903

  • R800 PSY UI62010

       UP19/03/22 P F903

  • R80M PSY UI62011

       UP19/03/22 P F903

  • R900 PSY UI62012

       UP19/03/22 P F903

  • R90M PSY UI62013

       UP19/03/22 P F903

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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
02 April 2019