PK91685: DFHW20151 SERVICE PROGRAM DFHW2TS OR DFHW2FI TERMINATED ABNORMALLY WITH ABEND CODE AEXZ PROCESSING POST OR PUT

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• An AEXZ abend was reported in a DFHW20151 message for a POST or
  PUT request to an Atom collection. Some unicode characters
  cannot be correctly converted into EBCDIC and back by the z/OS
  System Services parser. When these are included in the body of a
  POST or PUT request to an Atom collection an AEXZ abend is seen
  in the supplied service program DFHW2TS or DFHW2FI. This abend
  is seen because the service program does not have special case
  code for "expected" errors but just treats all parse errors as
  serious failures. The return and reason codes from the parser
  can be obtained from the DFHML0100.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: Abend AEXZ in supplied service program  *
  *                      (DFHW2TS/DFHW2FI) when POSTing/PUTting  *
  *                      unparsable characters to an Atom        *
  *                      collection.                             *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The data in the Atom entry received on a POST or PUT request to
  an Atom collection is converted into EBCDIC before being written
  to the appropriate file or queue. If this data contains unicode
  characters that have no EBCDIC equivalent the parser converts
  these to substitute characters, but this conversion is not
  necessarily reversible. When the EBCDIC is converted back into
  unicode the substitute characters cannot be converted and the
  parser fails with reason code XRSN_CONTNT_CHAR_INVALID as
  reported in message DFHML0100. When the code that issued the
  parse sees that it has failed it assumes the problem is a severe
  error and so abends AEXZ as reported in the DFHW20151 message.
  

Problem conclusion

• The code that receives the parse error has been changed to
  handle this situation better, failing the POST or PUT request
  and returning an HTTP status code 400 to the caller rather than
  abending.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK49544

Modules/Macros

• DESW2CM  DFHW2FI  DFHW2TS
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R600 PSY UK49544

     UP09/08/28 P F908

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.