/START NODE command

Use the /START NODE command to allow IMS to accept logons from, or initiate logons to, terminals attached to VTAM® without actually initiating a session with the terminal. When a stopped node is started by using the /START NODE command, the terminal can log on to IMS or IMS can initiate a session with the terminal by using the /OPNDST NODE command.

The /START NODE command operates only if the node is disconnected, idle, and stopped. In addition to resetting the STOPPED status, the command resets MFSTEST mode, exclusive mode, DEACT status, and conversational mode by terminating the conversations.

Subsections:

Environment

The following table lists the environments (DB/DC, DBCTL, and DCCTL) in which you can use the commands and keywords.

Table 1. Valid environments for the /START NODE command and keywords
Command / Keywords DB/DC DBCTL DCCTL
/START X X X
NODE X   X
USER X   X

Syntax

Read syntax diagramSkip visual syntax diagram/START/STANODE nodenamenodename*nodenameUSERusernameALLALL

Usage notes

The /START NODE command is valid for existing nodes only (including any temporary nodes present in the system).

There is no need to issue a /DEQUEUE command for Fast Path messages. When the response mode is reset for a NODE or USER destination of Fast Path messages by either a /STOP NODE or a /STOP USER command, the Fast Path messages are discarded when the accompanying /START NODE or /START USER command is issued. In this case, IMS writes a X'67D0' Subtype 11 trace log record.

The /START NODE nodename USER username command applies to ISC sessions only, and it is used to start a half session allocated to USER username for NODE nodename. The USER keyword when used with the NODE keyword affects the specified half-session. When the USER keyword is omitted, all half-sessions of the specified node are affected.

Restrictions for using NODE and USER parameters together:
  • Commands with the NODE USER keyword pair are valid only if:
    • The USER is signed on to the NODE
    • In an ISC environment, the USER is allocated to the NODE
    • The nodes and users already exist
  • /START NODE USER commands are valid for ISC, LUP, and 3600 nodes only.

The NODE parameter can be generic if the USER keyword is not present. The generic parameter specifies nodes that already exist.

The /START NODE command no longer resets test mode and preset mode, because these statuses are no longer significant and therefore no longer carried across logon or restart. MFSTEST mode (at the node level) and exclusive mode are still reset.

If global resource information is kept in Resource Manager, the /START NODE command allows a node to log on to any IMS in the IMSplex and resets MFSTEST mode and exclusive mode. If the node no longer has significant status, it is deleted from Resource Manager.

If a node in conversational mode receives the message, DFS058I START COMMAND COMPLETED EXCEPT when a /START NODE command is issued, it is possible that the conversation is INUSE by some other process. This is a temporary condition; you can reissue the /START NODE command.

Examples

The following is an example of the /START NODE command:

Entry ET: 
/START NODE HARRY
Response ET: 
DFS058I  START COMMAND COMPLETED

Explanation: The physical terminal that is associated with the node HARRY is started.