A fix is available
APAR status
Closed as program error.
Error description
This is a backport of PH44682. The customer issues an EXEC CICS PERFORM SHUTDOWN from their own transaction but the shutdown hangs. The joblog confirms that CESD has ended all non-system tasks : 16.37.41 JOB39003 +DFHCESD applid SHUTDOWN ASSIST TRANSACTION CESD STARTING. SHUTDOWN IS NORMAL. 16.37.41 JOB39003 +DFHTM1782I applid All non-system tasks have been successfully terminated. This is followed by : 16.37.42 JOB39003 +DFHZC2305I applid Termination of VTAM sessions beginning and 16.38.41 JOB39003 +DFHZC2352 date time applid SYSID NETNAME Intersystem parallel connection still active after TC shutdown threshold expired. ((1) Module DFHZSHU). Several minutes later the region is still running so the customer attempts to run their shutdown transaction again, but this fails : +DFHAC2007 date time applid Transaction xxxx cannot run as CICS shutdown is in progress. and they eventually cancel the region.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users. * **************************************************************** * PROBLEM DESCRIPTION: CICS hangs during normal shutdown when * * two attempts to issue CNOS to zero * * for a parallel LU6.2 connection fail * * with SEND errors. * **************************************************************** A CICS region specifies DFHSIT parameters TCSACTN=FORCE and TCSWAIT with a numerical threshold value. These are set to request that CICS terminal control takes action to forceclose the CICS z/OS Communications Server ACB after the threshold time expires during normal shutdown. However, message DFHZC2352 in the joblog indicates the hang. DFHZC2352 date time applid SYSID NETNAME Intersystem parallel connection still active after TC shutdown threshold expired. ((1) Module DFHZSHU). A request for CNOS (change number of sessions) to zero is sent across a parallel LU6.2 connection and an error response is returned with message DFHZC0161 and error code X'FBB1'. DFHZC0161 date time applid CLS1 CNOS command for modename MNAME to node NETNAME connection SYSID has failed with code X'FBB1'. CICS retries the CNOS request but this SEND also fails with the same message and error code. The failure to successfully complete CNOS close processing prevents the TCSACTN=FORCE action from taking place. Additional keywords: ZC0161 MSGDFHZC0161
Problem conclusion
CICS is changed to allow the TCSACTN=FORCE action to go ahead and forceclose the CICS z/OS Communications Server ACB if a second attempt to complete CNOS close processing, for an LU62 parallel connection, returned a SEND error with message DFHZC0161 and code X'FBB1'.
Temporary fix
Comments
APAR Information
APAR number
PH54747
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
100
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2023-05-25
Closed date
2023-10-04
Last modified date
2023-11-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI93877
Modules/Macros
DFHBSSZ DFHTCTTE DFHTCTZE DFHZGCN DFHZSHU
Fix information
Fixed component name
CICS TS Z/OS V5
Fixed component ID
5655Y0400
Applicable component levels
R100 PSY UI93877
UP23/10/06 P F310
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":"5.4","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
02 November 2023