/EXCLUSIVE command

Use the /EXCLUSIVE command to put a terminal into exclusive mode. This command, without keywords, is valid from a terminal with a signed on user.

The LINE PTERM and NODE keywords are only valid for output-only terminals. For a dynamically created user, the exclusive mode status is remembered across signons.

Subsections:

Environment

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

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

Syntax

Read syntax diagramSkip visual syntax diagram/EXCLUSIVE/EXCLINEline#PTERMpterm#NODEnodenameUSERusername

Keywords

The following keywords are valid for the /EXCLUSIVE command:

LINE PTERM
Specifies the communication line to be put into exclusive mode. The /DISPLAY LINE line# PTERM pterm# command identifies a terminal in exclusive mode.
NODE
Specifies that the static VTAM® node be put into exclusive mode. This command is not valid for nodes that were dynamically created.
USER
Specifies that the dynamic user be put into exclusive mode. If the user does not exist in IMS, it and its associated LTERMs will be created to remember the exclusive status. If /EXCLUSIVE USER is issued against an existing user, the user must be dynamic.

Usage notes

Exclusive mode restricts the output received by the terminal affected:
  • A regular input/output terminal in exclusive mode only receives messages transmitted in response to transactions entered from that physical terminal.
  • An output-only terminal in exclusive mode receives messages transmitted in response to transactions entered into its associated input logical terminals.

Except for an IMS system message responding to an error condition, all other output for a terminal in exclusive mode remains queued for later transmission. The queued output is transmitted after exclusive mode is reset with the /END command or a /START command.

In an IMSplex, if global resource information is kept in Resource Manager, the /EXCLUSIVE command sets a global exclusive status for the resource. If global resource information is not kept in Resource Manager, the /EXCLUSIVE command sets the status.

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

The /END command is used to get a terminal out of exclusive mode.

Examples

The following are examples of the /EXCLUSIVE command:

Example 1 for /EXCLUSIVE command

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

Explanation: No messages are sent to this terminal other than application program output resulting directly from transaction input.

Example 2 for /EXCLUSIVE command

Entry ET: 
  /EXCLUSIVE USER alpha
Response ET: 
  DFS058I  EXCLUSIVE COMMAND COMPLETED