IBM Support

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

A fix is available

Subscribe

You can track all active APARs for this component.

 

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.2 Messages and Codes (GC34682700) 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:  The request is abandoned. Error processing
    will continue.
    
    USER RESPONSE:  For a timeout error: Investigate why the
    remote server failed to respond in a timely manner. Consider
    changing the RESPWAIT value for the pipeline which processes
    these web service requests.  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

  • ž**** PE07/10/29 FIX IN ERROR. SEE APAR PK54253  FOR DESCRIPTION
    

APAR Information

  • APAR number

    PK48580

  • Reported component name

    CICSTS V3 Z/OS

  • Reported component ID

    5655M1500

  • Reported release

    500

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2007-07-10

  • Closed date

    2007-09-26

  • Last modified date

    2007-10-31

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

    PK44965

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

    UK29554

Modules/Macros

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

Publications Referenced
GC34682700    

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R500 PSY UK29554

       UP07/09/28 P F709

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.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
31 October 2007