/TRACE TIMEOUT command
Use the /TRACE TIMEOUT command to start or stop the I/O Timeout Detection facility.
Subsections:
Environment
The following table lists the environments (DB/DC, DBCTL, and DCCTL) in which you can use the commands and keywords.
| Command / Keywords | DB/DC | DBCTL | DCCTL |
|---|---|---|---|
| /TRACE | X | X | X |
| AUTO | X | X | |
| MSG | X | X | |
| SET | X | X | X |
| TIMEOUT | X | X |
Syntax
Keywords
The following keywords are valid for the /TRACE TIMEOUT command:
- time#
- is the number of minutes used to determine if the I/O response
is overdue. After this number of minutes, time has run out for the
response. The range is from 1 through 60; the default value is 0.
If time# is 0, or not specified, then when I/O is initiated for a node, the node will be placed on a queue, so that its status can be displayed with the /DISPLAY TIMEOVER command. You will not be notified if the node does not receive a response and the time elapses, and the node will not be reactivated.
If time# is not 0, then the following keywords can be used.- MSG
- Indicates that a message is issued to the master terminal when I/O takes longer than time# minutes. The message indicates that the time has elapsed.
- AUTO
- IMS issues a message to the master terminal, then perform a VTAM® VARY NET,INACT and a VARY NET,ACT, if I/O takes longer than time# minutes. An /OPNDST is performed for operable devices that are not shared. For ISC nodes, a message is issued, but there is no automatic (AUTO) restart of any sessions and no VTAM VARY commands issued.
Usage notes
If you want to change the time period or the action to be taken if timeout occurs, you can enter the /TRACE SET … TIMEOUT command while the Timeout Detection facility is already active. However, if nodes are receiving or sending input or output, they will function according to the previous settings of the /TRACE … TIMEOUT command. If this is undesirable, then you should enter the /TRACE SET OFF TIMEOUT command before reentering /TRACE SET … TIMEOUT.
If the timeout trace facility failed during IMS initialization, the /TRACE SET … TIMEOUT command is rejected with an error message.
The VTAM TIMEOUT I/O facility is automatically started during IMS shutdown. It is set for 1 minute and AUTO.