/RSTART command

Subsections:

• Environment
• Syntax
• Keywords
• Usage notes
• Equivalent IMS type-2 commands
• Examples

Environment

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

Syntax

Keywords

The following keywords are valid for the /RSTART command:

LINE

Specifies the line or line/physical terminal to be started with all terminals on the line in the same mode of operation they were in when they were stopped. The /RSTART LINE command allows all input, output, and queuing to start on the line and take the line out of response mode if the line was in this mode. The /RSTART LINE PTERM command does not reset line response mode, but does reset the non-VTAM-attached 3270 terminal response mode and looptest mode.

LOPEN

LOPEN enables stopped and idle remote non-VTAM lines. Enter the /RSTART LINE LOPEN command before any /RSTART LINE PTERM command to avoid having a line that is stopped and idle reset before it can be enabled again. If the line is not stopped or process stopped, and idle, or if enabling is not applicable, the LOPEN keyword is ignored and processing continues.

/RSTART LINE and /RSTART NODE cannot reset terminal response mode if Fast Path is active for a specified physical terminal or node. The /DEQUEUE command must be entered to discard Fast Path output before using the /RSTART command.

LINK

Specifies the logical links to be started, either individually or all at once.

For TCP/IP and VTAM® links, the /RSTART LINK command can be issued in either one of the two partner systems to start communication. For CTC or MTM links, communication does not begin until the /RSTART LINK command is entered in both partner IMS systems.

The /RSTART LINK command is rejected unless the link is in a stopped and idled status and the assigned physical link is open, as shown in the /DISPLAY command.

MODE

The MODE keyword allows you to specify mode table entries to be used when activating an IMS VTAM MSC session. Use of the MODE keyword with non-VTAM links is invalid. If non-VTAM links are referred to specifically in the /RSTART LINK command with the MODE keyword, they will be marked in error.

MSPLINK

Resets the PSTOPPED status of MSC TCP/IP or VTAM links to enable logons. If the TCP/IP link is used with TCP/IP generic resources, this keyword also resets the PSTOPGEN status.

NODE

Specifies the VTAM node for which input, output, and queuing will start. The /RSTART NODE nodename USER username command restarts the ISC half-session allocated to username for nodename. The USER keyword is valid only with the NODE keyword and restarts the specified half-session. If 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
• The /RSTART NODE USER commands are valid for ISC, LUP, and 3600 nodes only.

The NODE parameter can be generic if the USER keyword is not specified. The generic parameter specifies nodes that already exist. If the node was created temporarily to retain status data and the status conditions have been reset, then the node is deleted at the next simple checkpoint.

If global resource information is not kept in Resource Manager, the /RSTART NODE command allows a node to logon to the local IMS, without resetting local status. If global resource information is kept in Resource Manager, the /RSTART NODE command allows a node to logon to any IMS in the IMSplex, without resetting global node status kept in Resource Manager. If the node no longer has significant status, it is deleted by Resource Manager.

USER

Specifies the USER for which input, output, and queuing are to start. This command starts the USER without resetting conditions such as conversation mode, exclusive mode, and test mode. The /RSTART USER command applies only to dynamic users.

The USER parameter can be generic where the generic parameter specifies already existing users.

If the user structure is temporary and was created solely to retain status that is now reset, the temporary user is deleted at the next simple checkpoint.

If global resource information is not kept in Resource Manager, the /RSTART USER command allows a user to sign on to the local IMS. If global resource information is kept in Resource Manager, the /RSTART USER command allows a user to sign on to any IMS in the IMSplex. If the user no longer has significant status in Resource Manager, it is deleted.

Usage notes

The /RSTART command checks the validity of all parameters entered by the terminal operator. If an error is detected on parameters that are independent of one another, only the invalid parameters are flagged as being in error and the /RSTART command processes the rest of the parameters.

The /RSTART command can be used to reset conditions previously established by the /START, /STOP, /PSTOP, /PURGE, /MONITOR, /COMPT, or /RCOMPT command.

This command can be issued to an IMSplex using the Batch SPOC utility.

Equivalent IMS type-2 commands

The following table shows variations of the /RSTART command and the IMS type-2 commands that perform similar functions.