A fix is available
APAR status
Closed as program error.
Error description
The following error message occurred in the CPSM WUI address space: com.ibm.cics.drake.jcpsm.RecordDecoder W Unexpected value decoding attribute CHANGEAGENT com.ibm.cics.drake.jcpsm.DataType¢DecodingException: Enum not found for value: 0 . This was a GraphQL request, scoped to a region. The GraphQL interface queried the PLEX for topology information about the region that the query was being scoped to, requesting the CSYSDEF resource. In this case the CSYSDEF resource was defined prior to version 4.1 and had not been updated with a later release. The CHANGEAGENT was added in 4.1, and can only be set on definitions that are created or altered with a release higher than this. This resulted in the CHANGEAGENT value being null x'00' on these resources, as seen in the message 'Enum not found for value: 0'. . A normal CMCI request would handle this correctly, showing 'N_A' as a value. However the GraphQL interface does not correctly handle the null x'00' value. This leads to GraphQL attempting to return a value based on a fixed set of values that were introduced with the CHANGEAGENT value and the Java exception is tripped. .
Local fix
Update the CSYSDEF resources involved to provide a valid value in the CHANGEAGENT field.
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM Users. * **************************************************************** * PROBLEM DESCRIPTION: Requesting the CHANGEAGENT field for a * * resource through the CICS CMCI GraphQL * * interface can result in an exception * * with error : * * Unexpected value decoding attribute * * CHANGEAGENT * **************************************************************** * RECOMMENDATION: The PTF correcting this APAR should be * * applied to all CICSPlex SM WUI regions and * * CICS System Management Single Server (SMSS) * * regions. The regions should then be * * restarted. * **************************************************************** Resources defined at releases prior to 4.1, which have not been altered do not have a CHANGEAGENT value set, and the internal value is 0. However the 0 value is not an expected value in the enumeration used by the GraphQL application. When it processes a resource with a 0 CHANGEAGENT value and attempts to render it as a string representation of the internal value, it does not find a matching value for 0. This results in an exception which is output to the JVM such as : com.ibm.cics.drake.jcpsm.RecordDecoder W Unexpected value decoding attribute CHANGEAGENT com.ibm.cics.drake.jcpsm.DataType$DecodingException: Enum not found for value: 0 The JSON response to the GraphQL request also contains an error for the CHANGEAGENT field, for example : "errors": [ { "message": "Exception while fetching data (/cicsplex/drep/ cpsmDefinitions/csysdef/records[0]/changeAgent) : Unexpected value detected in output for CSYSDEF.CHANGEAGENT", "locations": [ { "line": 8, "column": 13 } ]
Problem conclusion
The enumeration mapping used by GraphQL for the CHANGEAGENT field for applicable resources has been altered, to return a "N_A" string value, when the CHANGEAGENT value is 0, for resources defined prior to 4.1.
Temporary fix
Comments
APAR Information
APAR number
PH55504
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
200
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2023-06-30
Closed date
2023-11-20
Last modified date
2023-12-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Modules/Macros
DFJ@H531 DFJ@H532 DFJ@H533 DFJ@H583
Fix information
Fixed component name
CICS TS Z/OS V5
Fixed component ID
5655Y0400
Applicable component levels
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"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.5","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
04 December 2023