PH09525: SENDING A CMCI REST REQUEST VIA A DATAPOWER ADDS AN XML DECLARATION WHICH CAUSES PROBLEMS PARSING THE REQUEST

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When sending a CMCI REST request via a DataPower it adds an XML
  declaration like <?xml version="1.0" encoding="UTF-8"?>.  This
  causes problems parsing the REST request resulting in an HTTP
  400 response and a fault with message DFHWU4007.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CPSM users for V5R3M0, V5R4M0 and        *
  *                 V5R5M0.                                      *
  ****************************************************************
  * PROBLEM DESCRIPTION: If a CMCI request body with an XML      *
  *                      declaration tag, for example, <?xml     *
  *                      version="1.0" encoding="UTF-8"?>, then  *
  *                      a HTTP 400 response is returned and     *
  *                      CICS will issue message DFHWU4007.      *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves         *
  *                 PH09525, all WUI regions must be recycled    *
  *                 to pick up the new code. Note that the       *
  *                 restarts do not need to occur at the same    *
  *                 time.                                        *
  ****************************************************************
  After receiving a POST or PUT request over CMCI, DFHWUXML is
  invoked to parse the request body. DFHWUXML does not regard
  the XML declaration tag as a valid tag.
  If a CMCI request body begins with XML declaration tag, such as
  <?xml version="1.0" encoding="UTF-8"?>
  then a HTTP 400 response is returned and CICS issues message:
  DFHWU4007 The body of the HTTP request was not specified
            correctly.
  .
  Additional Keywords: msgDFHWU4007 WU4007
  

Problem conclusion

• DFHWUXML has been modified to to parse and validate an XML
  declaration tag.
  

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:

  UI63186 UI63187 UI63188 UI63189 UI63190 UI63191

Modules/Macros

• DFHWUTRI DFHWUXML
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R000 PSY UI63186

     UP19/05/24 P F905

• R00M PSY UI63187

     UP19/05/24 P F905

• R100 PSY UI63188

     UP19/05/24 P F905

• R10M PSY UI63189

     UP19/05/24 P F905

• R200 PSY UI63190

     UP19/05/24 P F905

• R20M PSY UI63191

     UP19/05/24 P F905

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.