1  SELECT
   PCA Command

   Selects a screen display as the current output, plot, source,
   scrolling, error, or input display.

   Format

     SELECT  [display-name]
 

2  Parameters
 

disp-name

   Specifies the display to be selected. You may specify any one
   of the following, with the restrictions noted in the qualifier
   descriptions:

   o  A predefined display (SRC, OUT, PLOT, and PROMPT).

   o  A display previously created with the SET DISPLAY command

   o  A pseudo-display name: %CURDISP, %CURSCROLL, %NEXTDISP,
      %NEXTOUTPUT, %NEXTPLOT, %NEXTSCROLL, %NEXTSOURCE

   If you omit this parameter and do not specify a qualifier, you
   deselect the current scrolling display (no display then has the
   scrolling attribute). If you omit this parameter but specify a
   qualifier (/INPUT, /SOURCE, and so on), you deselect the current
   display with that attribute (see the qualifier descriptions).
 

2  Description
   Attributes are used to select the current scrolling display and
   to direct various types of PCA output to particular displays.
   This gives you the option of mixing or isolating different types
   of information, such as PCA input, output, diagnostic messages,
   and so on in scrollable displays.

   You can use the SELECT command with one or more qualifiers
   (/ERROR, /SOURCE, and so on) to assign one or more corresponding
   attributes to a display. If you do not specify a qualifier, the
   /SCROLL qualifier is assumed by default.

   If you use the SELECT command without specifying a display
   name, in general the attribute assignment indicated by the
   command qualifier is canceled (deselected). To reassign
   display attributes you must use another SELECT command. See the
   individual qualifier descriptions for details.
 

2  Qualifiers
 

/ERROR

   If you specify a display, selects it as the current error
   display. This causes all PCA diagnostic messages to go to that
   display. The display specified must be either an output display
   or the PROMPT display.

   If you do not specify a display, the PROMPT display is selected
   as the current error display. By default, the PROMPT display has
   the error attribute.
 

/INPUT

   If you specify a display, selects it as the current input
   display. This causes that display to echo PCA input (which always
   appears in the PROMPT display). The display specified must be an
   output display.

   If you do not specify a display, the current input display is
   deselected and PCA input is not echoed to any display (PCA input
   appears only in the PROMPT display). By default, no display has
   the input attribute.
 

/OUTPUT

   If you specify a display, selects it as the current output
   display. This causes PCA output that is not already directed
   to another display to go to that display. The display specified
   must be either an output display or the PROMPT display.

   If you do not specify a display, the PROMPT display is selected
   as the current output display. By default, the OUT display has
   the output attribute.
 

/PLOT

   Directs all output from PLOT, TABULATE and related commands to
   the specified display. This display becomes the current plot
   display. By default, the PLOT display has the plot attribute.
 

/PROMPT

   Selects the specified display as the current prompt display.
   This is where PCA prompts for input. Currently, only the
   PROMPT display may be specified. Note that you cannot deselect
   the PROMPT display (the PROMPT display always has the prompt
   attribute).
 

/SCROLL

   If you specify a display, selects it as the current scrolling
   display. This is the default display for the SCROLL, MOVE,
   and EXPAND commands. Although any display may have the scroll
   attribute, note that you can use only the MOVE and EXPAND
   commands (not the SCROLL command) with the PROMPT display.

   If you do not specify a display, the current scrolling display is
   deselected and no display has the scroll attribute.
 

/SOURCE

   If you specify a display, selects it as the current source
   display. This causes the output of all TYPE commands to go to
   that display. The display specified must be a source display.

   If you do not specify a display, the current source display is
   deselected and no display has the source attribute.
 

2  Examples

 PCAC> SELECT/SOURCE/SCROLL SRC2

     The SELECT/SOURCE/SCROLL command selects display SRC2 as the
     current source and scrolling display.

 PCAC> SELECT/INPUT/ERROR OUT

     The SELECT/INPUT/ERROR command selects display OUT as the
     current input and error display. This causes PCA input,
     output (assuming OUT is the current output display), and PCA
     diagnostic messages to be logged in the OUT display in the
     correct sequence.

 PCAA> SELECT/SCROLL OUT
 PCAA> SCROLL/UP

     The first command selects the OUT display as the current
     scrolling display. The SCROLL command has no display-name
     parameter, and therefore scrolls the OUT display.

 PCAA> SELECT/PLOT

     This command cancels the plot display. All PLOT command output
     is directed to the output display.