PK44965: DFHPI0002 CODE 0507 AFTER PURGE OF WEBSERVICE REQUESTER DFHPITH SEVERE ERROR

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are running a task that issues an EXEC CICS INVOKE
  WEBSERVICE command. The task appears hung but has actually
  issued a receive to await the response from the webservice
  provider. You purged the task (webservice requester) using CEMT
  and message DFHPI0002 is issued with code x'0507', producing a
  dump. Purging the webservice requester while it is waiting for a
  response from the webservice provider should not cause a severe
  error (code X'0507') in DFHPITH.
  DFHPITH should handle wbcl_purged response without producing
  a dump.
  .
  The webservice requester task was waiting out of DFHWBCL, within
  routine READ_RESPONSE. The stack from the dump will look similar
  to the following:
  .
   0460 Sub  95EFD140 95EFD45A 031A  DFHEIPI
        Int     +01CA 95EFD2D2 0192  PROCESS_EXEC_ARGUMENTS
        Int     +024E 95EFD360 0220  INVOKE_WEBSERV
   0E50 Dom  95A20518 95A2191A 1402  DFHPIIW
        Int     +02CC 95A2070A 01F2  INVOKE_WEBERVICE
   0940 Dom  95A23C80 95A260DA 245A  DFHPIPM
   0C50 Dom  95A2D288 95A2E9C8 1740  DFHPITH
        Int     +0C9E 95A2D522 029A  DFHPITH_CONVERSE
        Int     +141E 95A2E216 0F8E  DFHPITH_CAPTURE_WBCL_FAILURE
        Int     +1682 95A2E76E 14E6  DFHPITH_SEVERE_ERROR
   0E90 Dom  953845B8 953885F2 403A  DFHMEME
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHPI0002 A severe error (code X'0507') *
  *                      has occurred in DFHPITH after a web     *
  *                      service request is purged.              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  EXEC CICS INVOKE WEBSERVICE is being used to invoke a remote
  webservice using outbound HTTP. The webservice response is not
  forthcoming and the task is purged using CEMT. DFHPITH receives
  a PURGED response from DFHWBCL Read_Response. Error handling
  logic in DFHPITH makes no provision for a PURGED response and so
  message DFHPI0002 is issued together with a PI0002 system dump.
  

Problem conclusion

• DFHPITH has been changed to correctly handle a PURGED
  response from DFHWBCL function READ_RESPONSE. If this response
  is received, message DFHPI0403 will be sent to destination CPIO.
  Pipeline manager has been changed to percolate a Purged
  response back to its invoker, whereby the task will be abended
  AEXY and a transaction dump taken.
  The CICS TS 3.1 Messages and Codes (GC34644203) will be
  updated. In Chapter 1 (DFH messages) the message DFHPI0403
  will be altered to read as follows:
  DFHPI0403  DATE TIME APPLID TRANID  THE CICS
            PIPELINE HTTP TRANSPORT MECHANISM FAILED TO
            RECEIVE A RESPONSE BECAUSE  {THE SOCKET RECEIVE
            WAS TIMED OUT |   THE TASK WAS PURGED} .
  
  EXPLANATION:  The CICS pipeline HTTP transport mechanism
  did not successfully receive a response to the outbound
  request due to the reason indicated in the message.
  
  o   The socket receive was timed out.
  
  o   The task was purged.
  
  SYSTEM ACTION:
  for timeout: The request is abandoned. Error processing
  will continue.
  for purged: The request is abended AEXY and a transaction dump
  is taken.
  
  USER RESPONSE:
  For a timeout error: Investigate why the
  remote server failed to respond in a timely manner. Consider
  changing the DTIMOUT value for the transaction that
  encountered this error.
  For a task purged error: Use the
  transaction dump from the AEXY abend to establish why the
  task was purged.
  
  DESTINATION:  CPIO
  
  MODULE:  DFHPITH
  
  XMEOUT PARAMETERS: date, time, applid,
  tranid, {1=the socket receive was timed out,
  2=the task was purged}
  

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:

  PK48580 UK27478

Modules/Macros

•    DESPIIS  DESPIIW  DESPIPM  DESPITH  DFHMEPIC
  DFHMEPIE DFHMEPIK DFHPIAP  DFHPIISC DFHPIISI DFHPIIW  DFHPIIWA
  DFHPIIWM DFHPIIWT DFHPIPM  DFHPIPMA DFHPIPMM DFHPIPMT DFHPIRT
  DFHPITH  DFHPIUCC DFHPIUCD DFH44965 MFHMEPIE
  

Fix information

• Fixed component name

  CICSTS 3.X Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK27478

     UP07/07/28 P F707

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.