IMS Version 9

/IDLE

Format

Read syntax diagramSkip visual syntax diagram                        .-------.
                        V       |
>>-+-/IDLE-+--+-LINE--+---line#-+-+--+--------+-+--------------><
   '-/IDL--'  |       '-ALL-------'  '-NOSHUT-' |
              |         .-------.               |
              |         V       |               |
              +-LINK--+---link#-+-+-------------+
              |       '-ALL-------'             |
              |         .---------------.       |
              |         V               |       |
              '-NODE--+---+-nodename--+-+-+-----'
                      |   '-nodename*-'   |
                      '-ALL---------------'

Environments and Keywords

Table 64 lists the environments (DB/DC, DBCTL, and DCCTL) from which the command and keywords can be issued.

Table 64. Valid Environments for the /IDLE Command and Keywords
Command / Keywords DB/DC DBCTL DCCTL
/IDLE X X
LINE X X
LINK X X
NODE X X
NOSHUT X X

Usage

/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.

LINE
Specifies the communication line to be immediately terminated.

/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.

NOSHUT
Immediately terminates input to and output from 3270 remote BTAM lines without a checkpoint shutdown. /IDLE cannot be entered before a checkpoint unless the NOSHUT keyword is included in the command. NOSHUT is only valid if IMS is not in the process of shutting down and is mutually exclusive with the NODE parameter. When /IDLE LINE line# NOSHUT is entered, the 3270 remote BTAM lines must be stopped or process stopped. A DFS058 COMMAND COMPLETED EXCEPT LINE X message is returned if the command is entered and one of the following conditions exists:

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.

LINK
Specifies the logical link from which input, or to which output, is to be terminated. (No input messages are lost with /IDLE LINK.)

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:

  1. First attempt to stop the link with the IMS /PSTOP command.
  2. If this fails, display the link session status through VTAM, using the VTAM command:
    D NET,ID=xxxxxxxx
    or the VTAM command:
    D NET,SESSIONS,LIST=ALL
  3. If the link session is still active (STATUS=ACTIV), terminate it with the /IDLE LINK command or the VTAM command:
    VARY NET,TERM,TYPE=FORCE,LU1=xxxxxxxx
    Note:
    All parallel sessions associated with the link will be terminated.
NODE
Specifies the VTAM node to which output is to be terminated, or from which input is to be terminated. The master terminal only can be idled when specifically named.

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.

Examples

Example 1 for /IDLE Command

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.

Example 2 for /IDLE Command

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.

Example 3 for /IDLE Command

Entry ET:

  /IDLE LINK 2

Response ET:

  DFS058I  IDLE COMMAND COMPLETED

Explanation: The input/output on logical link 2 is forced to terminate.

Example 4 for /IDLE Command

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.

Go to the previous page Go to the next page

IBM Confidential

Downloads | Library | Support | Support Policy | Terms of use | Feedback
Copyright: IBM Corporation 1974, 2004 Copyright IBM Corporation 1974, 2004  timestamp Last updated: March, 2004