PK32702: DFHRM0001 ABENDAKEF FOR CSNE TRANSACTION DURING CICS SHUTDOWN

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• CICS can fail during a normal shutdown with DFHRM0001
  messages:
  .
  DFHRM0001 AN ABEND (CODE ---/AKEF) HAS OCCURRED AT OFFSET
            X'00A2' IN MODULE DFHRMSLO.
  DFHRM0001 AN ABEND (CODE ---/AKEF) HAS OCCURRED AT OFFSET
            X'01E2' IN MODULE DFHRMSLW.
  DFHRM0001 AN ABEND (CODE ---/AKEF) HAS OCCURRED AT OFFSET
            X'00B0' IN MODULE DFHRMSL2.
  DFHRM0001 AN ABEND (CODE ---/AKEF) HAS OCCURRED AT OFFSET
            X'00B6' IN MODULE DFHRMSL3.
  .
  The problem occurs because a PLT program attempts to purge the
  CEMT task for the shutdown. The purge will be deferred, however,
  when DFHSTP issues a WAIT_OLDC to wait for terminal quiesce,
  DFHDSSR merely returns to DFHSTP with RESPONSE(PURGED)
  REASON(TASK_CANCELLED), and DFHSTP continues on as if terminal
  quiesce is now complete. The AP domain successfully quiesces,
  and the remaining domains follow. However, terminal quiesce
  wasn't actually complete. CSNE now runs, and a NEP (Node Error
  program) issues a START for a transaction with data, which
  uses a recoverable TS queue. When CSNE attempts to syncpoint
  this recoverable work, the AKEF 's are issued because the
  Logger domain has quiesced and is no longer available.
  

Local fix

• Ensure that the PLT program does not attempt to purge the
  shutdown task.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: Abend AKEF can occur if a PLT shutdown  *
  *                      program attempts to FORCEPURGE the      *
  *                      shutdown task.                          *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  On shutdown, if a PLT shutdown program issues a FORCEPURGE
  against the CEMT task which shut the region, the purge will
  be deferred by CICS. During shutdown DFHSTP issues a wait for
  terminal quiesce to complete. However, the dispatcher returns
  indicating that the task has been PURGED and because DFHSTP
  does not check the return code from the WAIT, DFHSTP continues
  processing as if terminal quiesce has completed. If the node
  error program then makes requests for service to a domain which
  has quiesced, e.g. recovery domain, an AKEF will result.
  
  Keywords: DFHRM0001 ABENDAKEF (CODE ---/AKEF) MSGDFHRM0001
            AP_QUIES CSASSI2 PLTSD FORCE_CANCEL TASK_CANCELLED
  

Problem conclusion

• DFHSTP has been changed to check the response issued by the
  wait call and to retry the wait if a reason of PURGED is
  returned.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PK29213

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

  PK34356 UK19840

Modules/Macros

•    DFHSTP
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK19840

     UP06/11/25 P F611

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.