/RCLSDST command

The /RCLSDST (remote close destination) command causes IMS to disconnect the VTAM® terminal from which the command is entered.

Subsections:

Environment

The following table lists the environments (DB/DC, DBCTL, and DCCTL) from which the command can be issued.

Table 1. Valid environments for the /RCLSDST command
Command DB/DC DBCTL DCCTL
/RCLSDST X   X

Syntax

Read syntax diagramSkip visual syntax diagram/RCLSDST/RCL

Usage notes

If you are in an active conversational mode, /EXIT or /HOLD must be entered before /RCLSDST is executed. If this command is issued by a signed on user, the user is signed off.

This command does not reset preset mode.

/RCLSDST 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 logons and restart. /RCLSDST also takes other actions depending on the recovery settings for the node:

RCVYSTSN=NO
/RCLSDST acts like a /CHANGE NODE COLDSESS command for FINANCE and SLUP nodes by setting the session status to 'cold'. /RCLSDST acts 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 /RCLSDST command, the next session initiation request for this node is 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
/RCLSDST causes any held IMS conversations to be terminated. Any conversational message that is queued or being processed has its output response message delivered asynchronously.
RCVYFP=NO
/RCLSDST causes Fast Path status and messages to be discarded.
RCVYRESP=NO
/RCLSDST resets full-function response mode.

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

Example

Entry ET:
  /RCLSDST
Response ET:
  DFS058I  RCLSDST COMMAND COMPLETED

Explanation: The entering terminal is logged off IMS.