PK32827: RECEIVE DFHPI0002 ERROR CODE X'0508' IN DFHPITH AFTER GETTING A DFHPI0401 AND DFHPI0503 AFTER THE CLIENT CLOSE'S THE CONNECTION.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Receive a DFHPI0002 at offset x'0508' in DFHPITH responding to a
  PIPELINE Request coming in from a Client.  The Client has closed
  the connection before we could send the response.  When we send
  the webservice response, DFHPITH receives an EXCEPTION with
  reason(CONNECTION_CLOSED). This is treated as a soft error and
  gives rise to the DFHPI0401 and DFHPI0503.
  .
  By this time, CICS has closed and deleted the socket object for
  this webservice request.
  .
  The START_PIPELINE returns a DISASTER and the pipeline router
  program(DFHPIDSH) reacts by calling DFHPITH to send an error
  response to the client.
  .
  This cannot succeed. However, as the socket object has now been
  deleted, this send request fails with:
  .
  EXCEPTION REASON(WBAP_SEND_ERROR).
  .
  DFHPITH's error handling routine DFHPITH_CAPTURE_WBAP_FAILURE
  has no logic to handle WBAP_SEND_ERROR so calls the Severe Error
  Routine which takes the System Dump.
  .
  CICS should not be taking a System Dump for this error.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHPI0401 and DFHPI0503 issued against  *
  *                      a PIPELINE request where the client has *
  *                      closed the connection before the        *
  *                      response is sent back from CICS.        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A Web Service request is processed and DFHPITH is called to send
  a SOAP response back. This fails with CONNECTION_CLOSED due to
  the client closing the socket.
  Messages DFHPI0401 and DFHPI0503 are correctly issued.
  DFHPIDSH then tries to send an error response to the client,
  this also fails and DFHPI0002 is issued and a system dump is
  unnecessarily taken.
  
  Additional Keywords: MSGDFHPI0401 MSGDFHPI0503 MSGDFHPI0002
  PI0002 PI0401 PI0503
  

Problem conclusion

• DFHPIDSH has been changed to no longer send an error response
  when the connection is closed by the client.
  This prevents DFHPI0002 and a system dump being issued.
  

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:

  UK21474

Modules/Macros

•    DESPIIS  DESPIPM  DFHPIDSH DFHPIISC DFHPIPM
  DFHPIPMA DFHPIPMM DFHPIPMT
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK21474

     UP07/01/26 P F701

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.