/CLSDST
Format

.---------------.
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:
-
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.
Example for /CLSDST Command
Entry ET:
/CLSDST NODE WEST
Response ET:
DFS058I CLSDST COMMAND COMPLETED
Explanation: The node, WEST, is disconnected from IMS.

IBM Confidential