IMS Version 9

/CLSDST

Format

Read syntax diagramSkip visual syntax diagram                          .---------------.
                          V               |
>>-+-/CLSDST-+--NODE--+-+---+-nodename--+-+-+---------------+--><
   '-/CLS----'        | |   '-nodename*-'   |               |
                      | '-ALL---------------'               |
                      |                   .----------.      |
                      |                   V          |      |
                      +-nodename--USER--+---username-+-+----+
                      |                 '-ALL----------'    |
                      '-nodename--+----------------+--FORCE-'
                                  '-USER--username-'

Environments and Keywords

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

Table 26. Valid Environments for the /CLSDST Command and Keywords
Command / Keywords DB/DC DBCTL DCCTL
/CLSDST X X
FORCE X X
NODE X X
USER X X

Usage

/CLSDST causes IMS to disconnect a VTAM terminal.

/CLSDST resets preset mode, test mode, response 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. /CLSDST will also do some other cleanup depending on the recovery settings for the node. Below are the actions taken:

RCVYSTSN=NO
/CLSDST acts like a /CHANGE NODE COLDSESS command for FINANCE and SLUP nodes by setting the session status to "cold". /CLSDST will act like a /QUIESCE NODE command for ISC (LU6.1) nodes by initiating the shutdown and deallocating the user for the specified node. This action changes the session status to cold. With these actions taken by the /CLSDST command, the next session initiation request for this node will be allowed to again attempt a session cold start. For ETO nodes, the control block structure could be deleted, if no significant status exists.
RCVYCONV=NO
/CLSDST causes any IMS conversations (active and held) to be terminated. Any conversational message that is queued or being processed will have its output response message delivered asynchronously.
RCVYFP=NO
/CLSDST causes Fast Path status and messages to be discarded.

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.

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, use the command /CLSDST NODE P1 FORCE. For ISC nodes with parallel sessions, the NODE and USER keywords must be specified and only one USER parameter is allowed.

FORCE operates under the following conditions:

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:

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.

Example for /CLSDST Command

Entry ET:

  /CLSDST NODE WEST

Response ET:

  DFS058I  CLSDST COMMAND COMPLETED

Explanation: The node, WEST, is disconnected from IMS.

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