PK89973: DFHPI0602 THE CICS SOAP HANDLER FAILED TO PARSE A MESSAGE. THE THE PASER ERROR CODE IS 0. THE DFHPIEP RETURN CODE IS 1.

Obtain the fix for this APAR.

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 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.