A fix is available
APAR status
Closed as program error.
Error description
This APAR has been created to opt-in to the Liberty Angel change made by Liberty APAR PH48202. This will prevent a cancelled Angel process from calling CALLRTM against the CICS job step TCB of a region containing a connected Liberty server process. CALLRTM against the CICS job step TCB can cause a CICS region to take many dumps and loop until force cancelled. Messages issued by CICS if this occurs will include DFHSJ0005, BPXP018I, DFHSJ0001, DFHSJ0002, DFHSJ1007, DFHKE0997 and DFHKE1800. An Angel should not be cancelled whilst it is connected to Liberty servers. The purpose of this APAR is to reduce the impact on CICS if this happens but errors will still occur.
Local fix
n/a
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users. * **************************************************************** * PROBLEM DESCRIPTION: CICS hangs or abends after cancellation * * of a Liberty angel process connected to * * a Liberty JVMSERVER. * **************************************************************** A Liberty JVMSERVER is enabled and connected to a Liberty angel process. The angel process is then cancelled which causes the angel to abend the connected Liberty server to prevent unpredictable results. This causes CICS to issue DFHSJ0005, DFHSJ0001 and DFHSJ0002 error messages, and attempt to disable then restart the JVMSERVER (DFHSJ1007). However, as the angel process has indicated the CICS job step TCB should be terminated, the CICS region either hangs or abends with messages DFHKE0997 and DFHKE1800 issued. Additionally, during the completion of this APAR it was found that the sjke_in_java flag used internally by CICS is not set correctly for a JVMSERVER's: - system thread when it is not in use - application threads before their first use
Problem conclusion
CICS has been updated to use the Liberty change made by PH48202. This means that if a Liberty JVMSERVER's connected angel process is cancelled the JVMSERVER will still fail with many error messages issued, but CICS will be able to successfully disable then re-enable it (assuming the required angel process is also restarted). Note, an angel process should not be cancelled whilst there are connected Liberty servers. The purpose of this APAR is to reduce the impact but the consequences are still severe. The updated CICS behaviour requires the Liberty JVMSERVER to be running version 22.0.0.9 or higher. Additionally, DFHSJIN has been updated to set sjke_in_java on and off as threads are dispatched into and return from the JVM.
Temporary fix
Comments
APAR Information
APAR number
PH52373
Reported component name
CICS TS Z/OS V6
Reported component ID
5655YA100
Reported release
400
Status
CLOSED PER
PE
NoPE
HIPER
YesHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2023-02-05
Closed date
2023-06-14
Last modified date
2023-07-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI92205
Modules/Macros
DFHSJIN DFHSJSC DFJ@H467 DFJ@H609
Fix information
Fixed component name
CICS TS Z/OS V6
Fixed component ID
5655YA100
Applicable component levels
R400 PSY UI92205
UP23/06/17 P F306 ¢
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":"PF054","label":"z Systems"}],"Version":"6.1","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
03 July 2023