/RCOMPT command

The /RCOMPT command sets a particular VTAM® terminal component to a ready/not ready state.

Environment

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

Table 1. Valid environments for the /RCOMPT command and keywords
Command / Keywords DB/DC DBCTL DCCTL
/RCOMPT X   X
CNS 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
VID X   X

Syntax

Read syntax diagramSkip visual syntax diagram
                .-1-------------------.               
                |          .-1------. |  .-READY--.   
>>-+-/RCOMPT-+--+-+-CNS-+--+--------+-+--+--------+------------><
   '-/RCO----'  | +-PCH-+  '-compt#-' |  '-NOTRDY-'   
                | +-PDS-+             |               
                | +-PRT-+             |               
                | +-RDR-+             |               
                | +-TDS-+             |               
                | +-UDS-+             |               
                | '-VID-'             |               
                +-2-------------------+               
                +-3-------------------+               
                '-4-------------------'               

Usage notes

Output messages queued for a particular component will not be sent unless the component is ready. Depending on terminal type, output operations for other components can continue.

Note: Defaults are READY and 1.
The ready/not ready state set by the /RCOMPT command can be altered by the following:
  • Another /RCOMPT command
  • A /COMPT, /START, or /RSTART command
  • An I/O error on the terminal component
The command format takes one of the following forms:
  • A keyword is used.

    A search is made of the components (as defined in the TERMINAL macro during IMS™ system definition or logon descriptor) for the component defined that corresponds to the specified keyword. When a match is found, that component type is made ready or not ready as specified by the command.

  • A keyword is used with a number other than 1 following the keyword.

    The corresponding occurrence of that component type is made ready or not ready, as specified by the command.

  • Number 1 through 4 is used instead of a keyword.

    The component affected is the one defined in that position during system definition or logon descriptor independent of component type.

When using ISC, only parameters 1, 2, 3, and 4 are valid.

Example

Entry ET:
  /RCOMPT VID 2 READY
Response ET:
  DFS058I  RCOMPT COMMAND COMPLETED

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

Entry ET:
  /RCOMPT 4 READY
Response ET:
  DFS058I  RCOMPT COMMAND COMPLETED

Explanation: The fourth component defined is declared ready to IMS.