PH39790: DFHSM0002 A SEVERE ERROR (CODE X'0305') HAS OCCURRED IN MODULE DFHSMGF.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Custom Adapter is used for Event Processing. After the CICS is
  upgraded to 5.6, the user started to get the following messages.
  
  
  DFHSM0002 applid A severe error (code X'0305') has occurred in
  module DFHSMGF.
  
  An SVC dump is captured as a result of DFHSM0002 message.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS reports invalid freemain errors    *
  *                      when an Asynchronous Event Adapter      *
  *                      transaction terminates.                 *
  ****************************************************************
  CICS is executing an Event Processing Asynchronous Event
  Adapter which is part of an AdapterSet.
  CICS function COPY_CHANNEL GETMAINs PGCRSET storage
  to hold EP container data.
  CICS then issues FREE_ALL_SET_STORAGE to FREEMAIN the storage,
  but specifies an incorrect channel token, so the storage is not
  FREEMAINed.
  The task which owns the PGCRSET storage ends, and the task
  storage is FREEMAINed by CICS.
  Later, when the Asynchronous Event Adapter transaction
  terminates, DELETE_OWNED_CHANNELS processing attempts to
  FREEMAIN the PGCRSET storage, which has already been freed.
  SM domain writes an exception trace:
  *EXC* Invalid_freemain_address PGCRSET,TASK.
  CICS issues message DFHSM0002 CODE X'0305'.
  

Problem conclusion

• DFHEPEV has been modified to use the correct channel token
  when it issues FREE_ALL_SET_STORAGE.
  

Temporary fix

Comments

APAR Information

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

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

  UI77296

Modules/Macros

• DFHEPEV
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R300 PSY UI77296

     UP21/09/25 P F109

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.