A fix is available
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 number
PK32702
Reported component name
CICSTS 3.1 Z/OS
Reported component ID
5655M1500
Reported release
400
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2006-10-11
Closed date
2006-11-20
Last modified date
2006-12-01
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.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
01 December 2006