/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.
Command / Keywords | DB/DC | DBCTL | DCCTL |
---|---|---|---|
/EXCLUSIVE | X | X | |
LINE | X | X | |
NODE | X | X | |
PTERM | X | X | |
USER | X | X |
Syntax
>>-+-/EXCLUSIVE-+--+----------------------------+-------------->< '-/EXC-------' +-LINE--line#--PTERM--pterm#-+ +-NODE--nodename-------------+ '-USER--username-------------'
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
- 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
/EXCLUSIVE
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
/EXCLUSIVE USER alpha
DFS058I EXCLUSIVE COMMAND COMPLETED