PH18332: DFHSM0002 0305 DFHSMGF DOUBLE FREEMAIN OF PROGRAM_LISTFREE STORAGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Running CICS TS 5.2 you experience the following error message:
  
  DFHSM0002 A severe error (code X'0305') has occurred in
                         module DFHSMGF
  
  Here is the exception trace entry from the dump:
  SM 0305 SMGF  *EXC* - Invalid_freemain_address -
                               FUNCTION(FREEMAIN)
                               ADDRESS(addr) STORAGE_CLASS(CICS)
  
  Searching on the addresss in trace, you can see it getmained
  by DFHPISN and also first freemained by DFHPISN.
  Then this  freed address is referenced in the following
  trace entry:
  
  PI 0C81 PISH  EXIT  RECEIVE-RESPONSE
                PROGRAM_LIST_PTR(addr)  <---
                HEADER_PROGRAM_RESPONSE(1)
                RESPONSE(1) REASON(0)
  
  DFHPISN then tries to freemain this same addr, causing the
  DFHSM0002 error
  
  Additional Symptom(s) Search Keyword(s): KIXREVDAM
  PROGRAM_LIST
  This problem is possibly related to APAR PI87928.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: A program that issues a web services    *
  *                      request abends SM0002 due to severe     *
  *                      error (code X'0305') in module DFHSMGF. *
  ****************************************************************
  A requester PIPELINE with 12 or more SOAP header handlers is
  installed in CICS.  A program issues an EXEC CICS INVOKE
  WEBSERVICE command that specifies this PIPELINE.
  The SEND-REQUEST phase of the PIPELINE works correctly, and it
  creates a PROGRAM_LIST structure for the SOAP header handlers
  which after calling them it then freemains.
  
  When a response is received, and the RECEIVE-RESPONSE phase of
  the PIPELINE runs it also creates a PROGRAM_LIST structure for
  the SOAP header handlers.  Since there are 12 or more SOAP
  header handlers a larger PROGRAM_LIST is getmained and the
  initial PROGRAM_LIST is freemained.
  However, although the RECEIVE-RESPONSE phase does correctly call
  each of the SOAP header handlers it keeps the address of the
  initial PROGRAM_LIST instead of the larger PROGRAM_LIST.
  This results in an abend SM0002 together with message DFHSM0002
  when it attempts to freemain the initial PROGRAM_LIST which has
  already been freemained.
  
  DFHSM0002 applid A severe error (code X'0305') has occurred in
  module DFHSMGF.
  
  Additional keywords: msgDFHSM0002
  

Problem conclusion

• DFHPISN routine process_response has been changed to return the
  correct PROGRAM_LIST address to be freemained.
  

Temporary fix

Comments

APAR Information

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

  PH10066

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

  UI66226

Modules/Macros

• DFHPISN
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R200 PSY UI66226

     UP19/11/30 P F911

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.