IST1688I
EXCESSIVE TIME elapsed DETECTED FOR STRUCTURE structure_name

Explanation

A coupling facility related process has not completed in elapsed minutes.

elapsed is the number of minutes since the process began.

structure_name is the name of the coupling facility structure to which the process is related.

The process may be one of the following:
  • Connecting to structure_name and repopulating the data in structure_name
  • Rebuilding structure_name
  • Performing peer recovery for another VTAM® which has failed or disconnected from structure_name

If VTAM has been waiting longer than 9999 minutes, *NA* is displayed for the value of elapsed. This message may be issued as a single message or as part of the IST1370I message group in response to DISPLAY NET,STATS,TYPE=CFS.

System action

Processing continues.

Operator response

This message is issued as a warning that the process might be stalled. VTAM will wait at least three minutes for the process to complete before issuing this message for the first time. Usually, three minutes is enough time to complete any of the processes listed above. However, in certain circumstances, these processes might legitimately require longer than three minutes to complete. These circumstance include: performing a rebuild of multiple coupling facility structures, multiple VTAMs connecting to the structure at the same time, multiple VTAMs disconnecting from the structure at the same time, or performing multiple back-to-back rebuilds. Allow extra time in these circumstances for the processes to complete before attempting to determine whether a stall situation has occurred.

Stall situations might occur for the following reasons: a VTAM failed to give a response during a rebuild, a VTAM failed to confirm a user sync point, or a VTAM failed to free a structure lock and other VTAMs are waiting to obtain the lock.

to determine whether there is a stall:

  1. Issue D XCF,STRNAME=structure_name. Examine the output to determine whether any connectors have outstanding responses or if there is an outstanding user sync point. See z/OS UNIX System Services Command Reference for information about the DISPLAY XCF command.
  2. For documentation purposes, obtain dumps of all VTAMs in the sysplex and also dump the coupling facility structure structure_name. If the connection process is attempted again, activate the CFS VIT option before obtaining the dumps.
  3. Issue the VARY NET,CFS,ACTION=DISCONNECT command on the systems with outstanding responses. After all the systems have disconnected, you may issue V NET,CFS,ACTION=CONNECT to have them reconnect to structure_name. See z/OS Communications Server: SNA Operation for information about the VARY CFS command.

System programmer response

None.

Routing code

2

Descriptor code

5