DFHZC2351 Date Time Applid termid netname Session still active after TC shutdown threshold expired. Reason: {01 Request in progress | 02 Task still active | 03 Waiting for SHUTC | 04 Waiting for BIS | 05 Waiting for UNBIND | 06 Waiting for RTR | 07 BID in progress | 08 Other TC work pending | 99 Undetermined} sense ((instance) Module name: {DFHZSHU}).

Explanation

CICS' attempt to shut down the network has not been completed within the time period allowed. The time period, the terminal control shutdown wait threshold, is specified by the TCSWAIT system initialization parameter. This message is issued for each VTAM terminal that is still active (not shut down) after the time period has expired.

In the message termid and netname are respectively, the CICS terminal identifier, and the VTAM network name of the hung terminal. One of the following is also included in the message to indicate the reason for the hang:

01

Request in progress

02

Task still active

03

Waiting for SHUTC

04

Waiting for BIS

05

Waiting for UNBIND

06

Waiting for RTR

07

BID in progress

08

Other TC work pending

99

Undetermined

System action

CICS may attempt a FORCECLOSE on the session but otherwise CICS terminal control shutdown continues normally. Whether CICS attempts a FORCECLOSE depends upon:

  • The coding of the TCSACTN system initialization parameter, and

  • How the installation's DFHZNEP (node error program) handles this condition.

If either of the following conditions is true:

  • TCSACTN=UNBIND, and this action is not changed by DFHZNEP,

  • TCSACTN=NONE, and this action is changed to FORCECLOSE (UNBIND) by DFHZNEP

CICS terminal control issues a VTAM CLSDST and sends an SNA UNBIND command. If neither of the conditions is true, no special action is taken.

Note:

CLSDST is not guaranteed to work in all circumstances.

The first 10 terminals (if there are that many) reported by this message are also included in message DFHZC2350.

User response

Check the state of the terminal. Check whether the associated DFHZC3437 message includes CLSDST. If DFHZC3437 does not include CLSDST, or it does but the CLSDST still fails to complete, take appropriate action outside of CICS to shut down the terminal.

If after a reasonable interval, terminal control shutdown still fails to complete (message DFHZC2316 is not displayed), take one of the following actions:

  • FORCECLOSE the CICS/VTAM ACB.

  • Perform a CICS CEMT PERFORM SHUTDOWN IMMEDIATE.

  • Cancel the CICS job from the operating system console.

Warning: Do not perform one of these actions unless there are no other suitable actions to take.

The reason why the terminal does not shutdown is more likely to be a problem with the terminal device or the network, than with CICS.

If messages DFHZC2350, DFHZC2351, and DFHZC2352 are issued too early or too late in the shutdown process, take appropriate steps to change the TCSWAIT system initialization parameter on future runs of CICS. Once CICS has initialized, TCSWAIT cannot be changed.

Module

DFHZSHU

XMEOUT parameters/Message inserts

  1. Date
  2. Time
  3. Applid
  4. termid
  5. netname
  6. Value chosen from the following options:
  7. sense
  8. instance
  9. Value chosen from the following options:

Destination

CSNE