A fix is available
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:
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
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