PH67289: CMCI QUERY ON TRANSACTION THAT HAS NOT COMPLETED XMAT ATTACH LEADS TO COM.IBM.CICS.DRAKE.JCPSM.RECORDDECODER ERROR MESSAGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A CMCI Query is executed and messages like the following are
  written out to the logs:
  
  com.ibm.cics.drake.jcpsm.RecordDecoder W Unexpected value
  decoding attribute TCB
  com.ibm.cics.drake.jcpsm.DataType$DecodingException: Enum not
  found for value: 1
  
  One of the transactions encountered in the query has not
  completed XMAT attach (e.g it is stuck in a TCLASS suspend). As
  a result of the state of the transaction, the INQUIRE TASK SPI
  call issued during the query replies back with an uninitialized
  value.
  
  KIXREVQWD
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM Users                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: Using the CMCI GraphQL interface        *
  *                      to retrieve a TASK resource where the   *
  *                      represented CICS task has not completed *
  *                      XMAT attach results error messages      *
  *                      within CMCI JVM server :                *
  *                                                              *
  *                      com.ibm.cics.drake.jcpsm.RecordDecoder  *
  *                      W Unexpected value                      *
  *                      decoding attribute TCB                  *
  *                                                              *
  *                      com.ibm.cics.drake.jcpsm.               *
  *                      DataType$DecodingException: Enum not    *
  *                      found for value: 1                      *
  ****************************************************************
  * RECOMMENDATION: The PTFs addressing this APAR should be      *
  *                 applied to WUI regions. These should then    *
  *                 be restarted.                                *
  ****************************************************************
  When a CICS task has not completed XMAT attach, the
  INQUIRE TASK SPI call returns with a 0 value for the TCB value.
  This is interpreted by the CPSM WUI and CMCI REST interface as
  a tcb="NOTAPPLIC" in the returned results. The CMCI GraphQL
  schema does not have mapping of the 0 value returned from the
  SPI to an enumeration value which would map to 'NOTAPPLIC'. As
  such the interface cannot correctly decode this value resulting
  in the error message in the JVM server logs, and an error on
  the request.
  

Problem conclusion

• The CMCI GraphQL interface has been updated to correctly map
  the 0 TCB value on the TASK resources to match the value
  returned by the WUI and CMCI REST interface.
  
  Further improvements to the error produced have been made in
  this case to detail the resource table as well as the attribute
  causing the error from RecordDecoder.
  

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:

  UO06803 UO06804 UO06805 UO06806 UO06807 UO06808

Modules/Macros

• DFJ@H531 DFJ@H532 DFJ@H533 DFJ@H583 EYUA0020 EYUC0020 EYUE0020
  EYUL0020 EYUP0020 EYUT0020 EYUY0020
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R400 PSY UO06807

     UP26/02/26 P F602

• R40M PSY UO06808

     UP26/02/26 P F602

• R500 PSY UO06805

     UP26/02/26 P F602

• R50M PSY UO06806

     UP26/02/26 P F602

• R600 PSY UO06803

     UP26/02/26 P F602

• R60M PSY UO06804

     UP26/02/26 P F602

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.