PM46195: COIE NSFW S0C1 DUE TO DFHCESD FORCEPURGE AT CICS SHUTDOWN

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You shutdown your CICS region while some active CICSPlex SM MAS
  methods are still processing.  The MAS agent does not purge
  these COIE tasks during shutdown.  When CICS DFHCESD purges the
  COIE tasks when they attempt to continue processing as method
  NSFW does in this instance, it will branch to lowcore as the
  NSFW_KLPB storage from the XLWA has been reused.  The JESMSGLG
  will contain messages similar to:
  .
  DFHCESD ATTEMPTING TO PURGE TRANID COIE
  .
  DFHAP0001 applid An abend (code 0C1/AKEA) has occurred at
  offset X'FFFFFFFF' in module EYU9XLOP.
  DFHME0116 (Module:DFHMEME) CICS symptom string for message
  DFHAP0001 is PIDS/5655S9700 LVLS/660 MS/DFHAP0001 RIDS/DFHSRP
  PTFS/UK58466 AB/S00C1 AB/UAKEA RIDS/EYU9XLOP ADRS/FFFFFFFF
  DFHDU0201 applid ABOUT TO TAKE SDUMP. DUMPCODE: AP0001  ,
  DUMPID: 1/nnnn
  .
  EYUXL0900I   Starting Environment Recovery
  EYUXL0903I Branch to location ZERO, Using R14 for Offset
  EYUXL0905E applid ASRA IN NSFW, OFFSET 000002B8 PSW=078D1000
  80000002
  EYUXL0905E INTC=0001 ILC=2 TXCP=00040001 SCODE=S00C1 TRAN=COIE
  TASK=nnnnnn
  EYUXL0905E Methods=NSFW,XLOP
  EYUXL0905E BEAR=00000000, OFFSET=????????
  .
  Additional Symptom(s) Search Keyword(s): KIXREVWJB
  EYU0NSFW offset x'2B8' R15 zeros
  SFLW_SET_FILE NSFL EYU0NSFL
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V4R1M0 and V4R2M0 Users      *
  ****************************************************************
  * PROBLEM DESCRIPTION: Various abends may occur in CPSM        *
  *                      methods and modules during MAS          *
  *                      shutdown, if CICS DFHCESD needs to      *
  *                      purge CPSM COIE or COIR tasks after     *
  *                      the MAS agent has terminated.           *
  *                                                              *
  *                      When this occurs, messages similar to   *
  *                      the following will be written to the    *
  *                      MAS's joblog and to the console:        *
  *                                                              *
  *                      DFHCESD ATTEMPTING TO PURGE TRANID COIE *
  *                      DFHCESD ATTEMPTING TO PURGE TRANID COIR *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes and MASes must be           *
  *                 restarted.  Note that the restarts do not    *
  *                 need to occur at the same time.              *
  ****************************************************************
  During the run of a MAS, COIE and COIR transactions may be
  started to perform processing for API, WUI, RTA or CICS Explorer
  requests.  During MAS agent shutdown, all active CPSM tasks with
  the exception of COIE and COIR tasks are terminated.  If these
  COIE and COIR tasks are subsequently purged after the MAS agent
  terminates, recovery processing for the tasks will attempt to
  access structures no longer valid in the region, resulting in
  various abends.
  

Problem conclusion

• Method EYU0NLRT (NLRT), has been updated to call method EYU0XLTP
  (XLTP) during MAS agent termination, to terminate COIE and COIR
  tasks.  XLTP will first post the termination ECBs for the tasks.
  If that does not result in the termination of the tasks, then
  XLTP will issue a purge for the tasks.  If XLTP issues a purge
  for a task, it will issue new message EYUXL0033I to the MAS's
  joblog and console.  The new message will look similar to the
  following:
  
    EYUXL0033I Attempting to PURGE TRANID(tranid), TASKID(taskid),
               METHOD(method), CALLER(cmethod).
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK72134 UK72135

Modules/Macros

•    CJA0NLHD CJB0NLHD CJC0NLHD EYUMCXLC EYUMCXLE
  EYUMCXLK EYURNLMO EYURXLOP EYUUXLEQ EYU0NLHD EYU0NLRT EYU0XLTP
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R60M PSY UK72134

     UP11/09/28 P F109

• R70M PSY UK72135

     UP11/09/28 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.