PH55504: UNEXPECTED VALUE DECODING ATTRIBUTE CHANGEAGENT ON WUI FOR GRAPHQL REQUEST

Obtain the fix for this APAR.

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 is sysrouted FROM one or more of the following:

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

  PH57119

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

• R200 PSY UI94548

     UP23/11/21 P F311

• R300 PSY UI94547

     UP23/11/21 P F311

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.