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

This command can be issued to an IMSplex using the Batch SPOC utility.

Subsections:

• Environment
• Syntax
• Keywords
• Examples

Environment

The following table lists the environments (DB/DC, DBCTL, and DCCTL) in which you can use the command and keywords.

Syntax

Keywords

The following keywords are valid for the /IDLE command:

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 non-VTAM® 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 non-VTAM 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:

• The line is the master terminal line or system console line, including the secondary master terminal line.
• The line is not stopped or process stopped.
• The line is not a 3270 remote non-VTAM line.
• The line is not open.
• The line is deactivated by IMS.

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:

• The link is idled already.
• The link is not connected.
• The link cannot be opened.
• A shutdown checkpoint is not in progress (for non-MSC VTAM links).

For MSC TCP/IP logical links that are active, the /IDLE LINK command immediately terminates the link. The /IDLE LINK command is similar to the /PSTOP LINK FORCE command because the /PSTOP LINK FORCE command also immediately terminates a TCP/IP logical link that is active. However, the /IDLE LINK command is processed only during IMS shutdown, whereas the /PSTOP LINK FORCE can be processed at any time.

IMS performs the following actions when it processes the /IDLE LINK command for an active TCP/IP link:

1. Terminates the link in the IMS system where the command is issued.
2. Notifies the local IMS Connect instance to clean up the send socket.
3. Issues the DFS2169I DISCONNECTION COMPLETED ON LINK informational message.
4. Places the link in PSTOPPED ERE IDLE status.

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