A fix is available
APAR status
Closed as program error.
Error description
Late in CICS shutdown, several regions reported errors for the health checker task CHCK: +DFHAP0002 A severe error (code X'1953') has occurred in module DFHAPLI3. The exception trace entry showed: AP 1953 APLI *EXC* - LE Lock Invalid Late in shutdown, CICS calls LE for PARTITION_TERMINATION which does a DELETE_LOCK for the LE_LOCK. This sets flag csz_lock_valid off. The health checker task, CHCK wakes up and program DFHHCHK does a LINK to DFHHCC1. The LINK will cause CICS to try to acquire the LE_LOCK. The lock request will fail with the LE_LOCK INVALID because the csz_lock_valid flag is off. This results in the DFHAP0002 1953 error. This is a shutdown timing issue when CHCK gets resumed between the delete of the lock and CICS actually terminating. Additional Symptom(s) Search Keyword(s): KIXREVPAD csa_lock_valid
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All. * **************************************************************** * PROBLEM DESCRIPTION: Abend DFHAP0002 during shutdown. * **************************************************************** This APAR addresses a timing issue when CICS is shut down. In the reported problem, an abend DFHAP0002 with error code X'1953' was issued during shutdown. An application issued an EXEC CICS SHUTDOWN. This drove DFHSTP which shuts down various components - including Language Environment (LE). Just as LE was shutdown, the HEALTHCHECKER came out of a SUSPEND to run as scheduled. However, it required an LE lock but this was no longer available as LE had just been terminated. CICS issued abend DFHAP0002 X'1953'. This problem does not present if using CEMT P SHUT.
Problem conclusion
CICS HEALTHCHECKER code has been amended to prevent the aforementioned scenario.
Temporary fix
Comments
APAR Information
APAR number
PH58100
Reported component name
CICS TS Z/OS V6
Reported component ID
5655YA100
Reported release
400
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2023-11-09
Closed date
2024-01-10
Last modified date
2024-02-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI95166
Modules/Macros
DFHHCHK
Fix information
Fixed component name
CICS TS Z/OS V6
Fixed component ID
5655YA100
Applicable component levels
R400 PSY UI95166
UP24/01/11 P F401
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"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"6.1","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
01 February 2024