PI53239: DFHPI0997 WHEN JSON RESTFUL WEB SERVICE, WITH NO REQUEST BODY, HAS A HANDLER PROGRAM IN THE PIPELINE CONFIG FILE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Customer is using a JSON Web Service in CICS. The JSON RESTful
  request has "GET" as the HTTP method and no request body.
  .
  The pipeline configuration file has <handler><program> specified
  in the pipeline configuration file.
  After the handler program has run, the DFHREQUEST is found to be
  empty and an error message is issued.
  DFHPI0997 The CICS pipeline manager has encountered an error:
  empty DFHREQUEST container returned from a handler.
  .
  CICS should be able to tolerate an empty DFHREQUEST container
  when JSON RESTful is used.
  

Local fix

• JSON Request-Response style web services will work. Removing the
  handler program from the configuration will allow the WS request
  to work.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: RESTful JSON request as GET is rejected *
  *                      incorrectly with message DFHPI0997 when *
  *                      a handler program is used.              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  CICS is acting as a JSON web service provider. The PIPELINE
  configuration file is defined with a handler program. A request
  is sent into a RESTful JSON web service. The request is a GET
  and does not include a message body. After the pipeline calls
  the handler program, DFHPIIS gets run to verify the current
  states and finds DFHREQUEST having a length of 0. Length is
  validly zero in this case and the handler did not change it but
  DFHPIIS treats this as an error and issues message DFHPI0997.
  Additional keywords: Java Pipeline, Axis2
  

Problem conclusion

• DFHPIIS has been changed to allow an unchanged zero length
  DFHREQUEST container to be handled as normal.
  

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:

  PI57694 UI36657 UI36658

Modules/Macros

• DFHPIAD  DFHPIAT  DFHPIA1  DFHPICA  DFHPICC  DFHPIDM  DFHPIDSH
  DFHPIDUF DFHPIII  DFHPIIW  DFHPILN  DFHPIMM  DFHPIPL  DFHPIPM
  DFHPIPM2 DFHPIPS  DFHPIRE  DFHPIRI  DFHPIRL  DFHPIRM  DFHPIRN
  DFHPIRS  DFHPISC  DFHPISF  DFHPISN  DFHPIST  DFHPITC  DFHPITC1
  DFHPITC2 DFHPITC3 DFHPITE  DFHPITH  DFHPITL  DFHPITQ  DFHPITRI
  DFHPITS  DFHPIUE  DFHPIWR  DFHPIWT  DFHPIXI  DFHPIXM  DFHPIXO
  DFHWSADH DFHWSATR DFHWSATX
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R800 PSY UI36657

     UP16/04/08 P F604

• R900 PSY UI36658

     UP16/04/08 P F604

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.