/COMPT command
The /COMPT command sets a particular terminal component to a ready or not-ready state.
Output messages queued for a particular component will not be sent unless the component is ready. Depending on terminal type and the availability of messages queued for other components, output operations for other components can continue.
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 |
---|---|---|---|
/COMPT | X | X | |
CNS | X | X | |
CRD | X | X | |
NODE | X | X | |
NOTRDY | X | X | |
PCH | X | X | |
PDS | X | X | |
PRT | X | X | |
RDR | X | X | |
READY | X | X | |
TDS | X | X | |
UDS | X | X | |
USER | X | X | |
VID | X | X | |
WPM1 | X | X | |
WPM2 | X | X | |
WPM3 | X | X |
Syntax
.-1------. >>-+-/COMPT-+--+-+-CNS--+--+--------+--NODE--nodename------+----> '-/COM---' | +-CRD--+ '-compt#-' | | +-PCH--+ | | +-PDS--+ | | +-PRT--+ | | +-RDR--+ | | +-TDS--+ | | +-UDS--+ | | +-VID--+ | | +-WPM1-+ | | +-WPM2-+ | | '-WPM3-' | '-+-1-+--NODE--nodename--+----------------+-' +-2-+ '-USER--username-' +-3-+ '-4-' .-READY--. >--+--------+-------------------------------------------------->< '-NOTRDY-'
Keywords
The following keywords are valid for the /COMPT command:
- CNS | CRD | PCH | PDS | PRT | RDR | TDS | UDS | VID | WPM1 | WPM2 | WPM3 | 1 | 2 | 3 | 4
- Specifies the component that you want to set to a ready or not-ready
state.
The command format can take two forms. That is, a component can be referenced by using a keyword, such as VID, or by using a number, such as 2.
When a keyword is used, a search is made of the components (as defined in the TERMINAL macro during IMS™ system definition) for the component type defined that corresponds to the specified keyword.
When a match is found, that component is made ready/not ready as specified by the command. If a number other than 1 follows the keyword, the corresponding occurrence of that component type is made ready/not ready.
/COMPT supports up to four components. When a number from 1 through 4 is used instead of a keyword, the component affected is the one defined in that position during system definition, independent of component type.
Restriction: When the /COMPT command contains the keyword CRD, it cannot also contain any of the following keywords: WPM1, WPM2, or WPM3. - READY
- Sets the specified terminal component to a ready state.
- NOTRDY
- Sets the specified terminal component to a not-ready state.
- NODE
- Specifies the node name (as specified by the TERMINAL macro) of the terminal component that is to be set in ready or not-ready state.
- USER
- Specifies the ISC subpool name of the nodename. The USER keyword is required if the node specified on the command is an ISC node.
Usage notes
- Another /COMPT command
- A /START, /RSTART, or /RCOMPT command
- An I/O error on the terminal component
The /COMPT command can only refer to a VTAM-attached terminal component.
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
- /COMPT (1|2|3|4) NODE USER (READY/NOTRDY) commands are valid for ISC and non-ISC nodes and users.
Examples
The following are examples of the /COMPT command:
Example 1 for /COMPT command
/COMPT 4 NODE ABC READY
DFS058I COMPT COMMAND COMPLETED
Explanation: The fourth component defined in the TERMINAL macro on node ABC is made ready to IMS.
Example 2 for /COMPT command
/COMPT VID 2 NODE ABC READY
DFS058I COMPT COMMAND COMPLETED
Explanation: The second display component on node ABC is declared operable to IMS.