IMS Version 9

/RCLSDST

Format

Read syntax diagramSkip visual syntax diagram>>-+-/RCLSDST-+------------------------------------------------><
   '-/RCL-----'

Environments

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

Table 137. Valid Environments for the /RCLSDST Command
Command DB/DC DBCTL DCCTL
/RCLSDST X X

Usage

/RCLSDST causes IMS to disconnect the VTAM terminal from which the command is entered. 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, response 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.

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 for /RCLSDST Command

Entry ET:

  /RCLSDST

Response ET:

  DFS058I  RCLSDST COMMAND COMPLETED

Explanation: The entering terminal is logged off 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