A fix is available
APAR status
Closed as unreproducible.
Error description
When your CICS V3.2 is a WebService requester, CICS receives a response message, which causes a parsing failure. The response message contains more than 70 namespace tags and produces the following message: DFHPI0602 The CICS SOAP handler failed to parse a message. The parser error code is 0. The DFHPIEP return code is 1. The error was found at offset X'7110' into the message. The Parser Error code 0, means the XML Parser has not reported the problem. The DFHPIEP return code 1, fc_out_of_memory, means a GETMAIN failure occurred while processing the SOAP message. CICS trace shows this exception: PI 0C16 PISN EXIT - SOAP_PARSER DFHPIEP_RC(1) PLISAXA_RC(0) AT_OFFSET(7110) The following CICS trace entry, shows the address and length of the response Soap message (PISNMSG), and the address and length of the data area used to parse the message (PARSEDAT). PI 0C15 PISN ENTRY - SOAP_PARSER TASK-04557 KE_NUM-0072 TCB-L8002/00776570 RET-B5DD6CD2 1-0000 3A53A008 00003AC4 3A5310F8 00000850 PISNMSG is located at 3A53A008, and has length x'3AC4'. PARSEDAT is located at 3A5310F8, and has length x'850'. The PARSEDAT size of x'850' is set in DFHPISN and is too small, which causes the fc_out_of_memory conditon. Additional Symptom(S) Search Keyword(S): KIXREVJXD PI0602 DFHPIEP PIEP FC_OUT_OF_MEMORY Additional reference: Diagnosing DFHPI0602 error messages http://www-01.ibm.com/support/docview.wss?uid=swg21264885
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS Users. * **************************************************************** * PROBLEM DESCRIPTION: Message DFHPI0602 was issued whilst * * parsing a SOAP message with a large * * with a large number of xmlns * * declarations. * **************************************************************** * RECOMMENDATION: * **************************************************************** CICS is being used as a Web Service provider. A large SOAP message is received by CICS. The SOAP message contains 156 xmlns declarations. DFHPISN procedure pisn_parse_envelope does a GETMAIN of storage, PARSEDAT, to pass to DFHPIEP. However, this storage is only large enough to accommodate approximately 70 xmlns declarations. The result of the call to DFHPIEP is that it returns to DFHPISN with a return code of 1, which is an out of memory error. This error led to message DFHPI0602 being issued.
Problem conclusion
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
DFHPISN has been amended to cater for a larger number of xmlns declarations within a SOAP message. The Parser can now handle approximately 200 xmlns declarations within a SOAP message.
APAR Information
APAR number
PK89973
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
500
Status
CLOSED UR3
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2009-06-26
Closed date
2009-09-29
Last modified date
2009-11-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK50635
Modules/Macros
DESPISN DFHPISN DFHPISNA DFHPISNC DFHPISND DFHPISNM DFHPISNT DFHPISN1 DFHPISN2
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R500 PSY UK50635
UP09/10/05 P F910
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:
04 November 2009