A fix is available
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