.-------. V | >>-+-/IDLE-+--+-LINE--+---line#-+-+--+--------+-+-------------->< '-/IDL--' | '-ALL-------' '-NOSHUT-' | | .-------. | | V | | +-LINK--+---link#-+-+-------------+ | '-ALL-------' | | .---------------. | | V | | '-NODE--+---+-nodename--+-+-+-----' | '-nodename*-' | '-ALL---------------'
Table 64 lists the environments (DB/DC, DBCTL, and DCCTL) from which the command and keywords can be issued.
Command / Keywords | DB/DC | DBCTL | DCCTL |
---|---|---|---|
/IDLE | X | X | |
LINE | X | X | |
LINK | X | X | |
NODE | X | X | |
NOSHUT | X | X |
/IDLE is used to immediately terminate input from, or output to, physical terminals assigned to the lines, logical links, or nodes specified in the command. Partially processed input messages on the lines specified in the command are discarded. Output messages being sent are returned to the message queues for later transmission.
/IDLE does not apply to the system console line, the master terminal line, or the secondary master terminal line. If these lines are specified, a DFS058 COMMAND COMPLETED EXCEPT LINE X message is returned. If the master terminal is assigned to a line that must be idle, the master terminal must be reassigned to a different line before /IDLE is specified.
If the line specified with the NOSHUT keyword belongs to a line group, the input and output for all lines within the group are immediately terminated. If the line belonging to the line group has the master terminal assigned to it, the /IDLE LINE line# NOSHUT command is rejected.
To restart the lines idled by the /IDLE LINE line# NOSHUT command, either the /START LINE or /RSTART LINE command must be entered.
If a checkpoint shutdown is not in progress, only MSC VTAM links are valid. All non-MSC VTAM links require a shutdown checkpoint in progress. IMS returns a DFS058 IDLE COMMAND COMPLETED EXCEPT LINK X message if one of the following conditions exists:
An /IDLE LINK link# command internally causes issuing of the VTAM command:
VARY NET,TERM,TYPE=FORCE,NOTIFY=NO,SCOPE=ALL,LU1=xxxxxxxx,LU2=yyyyyyyy
All logical links, assigned to the same physical link, associated with the named logical link (link#) will be stopped. That is, all parallel sessions on the same physical link will be stopped. The /RSTART LINK command is used to reactivate links or sessions.
The /IDLE LINK link# command should not be used as the first attempt to stop the link. If the MSC link appears to be hung, the IMS operator should:
D NET,ID=xxxxxxxxor the VTAM command:
D NET,SESSIONS,LIST=ALL
VARY NET,TERM,TYPE=FORCE,LU1=xxxxxxxx
If an /IDLE NODE nodename command is entered for an ISC node defined with users, all half-sessions of the specified node are affected.
An /IDLE NODE ALL command causes the VTAM command VARY NET,INACT, to be issued to all nodes still connected to IMS, except the master terminal.
If the /IDLE NODE command is entered prior to IMS entering shutdown, the /ACT command can be entered to reactivate the node in VTAM. If the /IDLE NODE command is entered while in IMS shutdown, a VARY NET,ACT command might have to be entered directly to VTAM. However, before using the /IDLE command, a /CLSDST and then a /CLSDST FORCE command should be tried.
The node parameter can be generic. The generic parameter specifies nodes that already exist.
Entry ET:
/IDLE LINE 14 24
Response ET:
DFS058I IDLE COMMAND COMPLETED
Explanation: The I/O on lines 14 and 24 is forced to terminate.
Entry ET:
/IDLE LINE 4 NOSHUT
Response ET:
DFS058I IDLE COMMAND COMPLETED
Explanation: The I/O on line 4, which is a 3270 remote BTAM line, is forced to terminate.
Entry ET:
/IDLE LINK 2
Response ET:
DFS058I IDLE COMMAND COMPLETED
Explanation: The input/output on logical link 2 is forced to terminate.
Entry ET:
/IDLE NODE ABC
Response ET:
DFS058I IDLE COMMAND COMPLETED
Explanation: A VARY NET, INACT command is executed that will cause the IMS VTAM LOSTERM exit to be entered with an indication that the session has been terminated.