/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.
Command | DB/DC | DBCTL | DCCTL |
---|---|---|---|
/RCLSDST | X | X |
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
/RCLSDST
DFS058I RCLSDST COMMAND COMPLETED
Explanation: The entering terminal is logged off IMS.