/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.

Table 1. Valid environments for the /COMPT 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

Read syntax diagramSkip visual syntax diagram
                           .-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

The ready or not-ready state set by the /COMPT command can be altered by the following:
  • 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

Entry ET:
  /COMPT 4 NODE ABC READY
Response ET:
  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

Entry ET:
  /COMPT VID 2 NODE ABC READY
Response ET:
  DFS058I  COMPT COMMAND COMPLETED

Explanation: The second display component on node ABC is declared operable to IMS.