/CLSDST command

Subsections:

• Environment
• Syntax
• Keywords
• Usage notes
• Example

Environment

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

Syntax

>>-+-/CLSDST-+--NODE-------------------------------------------->
   '-/CLS----'         

       .---------------.                         
       V               |                         
>--+-+---+-nodename--+-+-+-------------------+-----------------><
   | |   '-nodename*-'   |                   |   
   | '-ALL---------------'                   |   
   |                   .----------.          |   
   |                   V          |          |   
   +-nodename--USER--+---username-+-+--------+   
   |                 '-ALL----------'        |   
   |                                     (1) |   
   '-nodename--+----------------+--FORCE-----'   
               '-USER--username-'                

1. ISC TCP/IP nodes do not support the FORCE keyword.

Keywords

The following keywords are valid for the /CSLDST command:

FORCE

Allows IMS to reinitialize a hung node with I/O in progress. FORCE reinitializes one session and is valid only on an active IMS system. To activate FORCE on VTAM nodes, use the command /CLSDST NODE P1 FORCE.

For ISC VTAM nodes with parallel sessions, the USER keyword must be specified and only one USER parameter is allowed.

ISC TCP/IP nodes do not support the FORCE keyword.

FORCE operates under the following conditions:

• A display from VTAM indicates that no session exists. If a session does exist, or is in process, you must issue the VTAM command VARY NET,INACT,FORCE to terminate the session, and the command must successfully complete. This command terminates all parallel sessions.
  Attention: If VARY NET,INACT,FORCE is not issued or does not successfully complete before you issue the FORCE command, and the terminal is in the process of creation or termination, the results might be unpredictable.
• The session is connected to IMS and output is in progress. A /DISPLAY on the node indicates that a CID exists, that the node is connected (a status of CON is displayed), and that the node is not idle (a status of IDLE is not displayed).

NODE

Specifies the node to be disconnected by IMS. The specified node must be connected before a command is issued to disconnect it, as indicated by CON on the /DISPLAY NODE command referring to that terminal.

If the USER keyword is omitted for ISC nodes, all half-sessions of a session type 6 node are terminated. If the USER keyword is omitted, generic parameters are allowed for the NODE keyword.

The timing of the disconnection depends on the type of terminal:

• For keyboards or printers, console components and interactive terminals, the disconnection occurs at the next message boundary.
• For component types that group messages (such as a SLU 1 statement reader, printer, or disk), the disconnection occurs at the end of any group where processing is in progress.
• For 3270 displays, the disconnection occurs at the completion of the current (if any) I/O operation.

USER

Must be specified with the NODE keyword. NODE USER specifies the ISC user allocated to the ISC node or the dynamic user signed on to the dynamic node. When a /CLSDST NODE nodename USER username command is issued, it only affects the NODE if the USER is still associated with the node.

For non-ISC dynamic nodes, this command is valid only if the user is still signed on to the node. For ISC nodes, the half-sessions of the ISC node allocated to the specific users are terminated and the users are not deallocated from the session. On restart, the /OPNDST command must specify the same users and ID pairs.

Restrictions for using NODE and USER parameters together:

• Commands with the NODE USER keyword pair are valid only if:
  • The USER is signed on to the NODE
  • In an ISC environment, the USER is allocated to the NODE
  • The nodes and users already exist
• /CLSDST NODE USER commands are valid for ISC and non-ISC nodes and users.

Usage notes

/CLSDST resets preset mode, test mode, lock node, lock LTERM, pstop LTERM, and purge LTERM, because these statuses are not significant and therefore are not kept after a logon or restart.

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

If global resource information is not kept in Resource Manager (RM), /CLSDST logs a node off and resets status locally. If global resource information is kept in RM, /CLSDST resets status globally. If the node has no significant status, /CLSDST deletes the node in RM.

If ROUTE is specified, it should be specified with ROUTE(*). The command fails if not routed to the IMS where the node is active.