1  DISPLAY
   PCA Command

   Outputs the specified displays on the terminal screen or changes
   the attributes of those screen displays. Also used to refresh the
   terminal screen.

   Format

     DISPLAY  [display-name [AT window-spec] [display-kind] [,

              display-name [AT window-spec)] [display-kind]]])

     DISPLAY/REFRESH
 

2  Parameters
 

display-name

   Specifies the name of a screen display that you want to view or
   whose characteristics you want to modify. This screen display
   must be predefined (PLOT, SRC, OUT or PROMPT) or defined with a
   previous SET DISPLAY command.
 

window-spec

   Specifies a new screen window for the display. If you specify
   window-spec, the display is shown in that window. If you omit
   window-spec, the display remains in its current window.

   Window-spec can be the name of a predefined window, the name of
   a window you have defined with a SET WINDOW command, or a window
   specification of the form:
 

start-line,line-count[,start-column,column-count]

   Start-line is the screen line number at which you want the
   top border of the display to be placed. Line-count is the
   number of lines of text you want to see in the window. Start-
   column and column-count specify the leftmost column and the
   number of columns in the window, respectively. Start-column and
   column-count default to column 1 and the current screen width,
   respectively.
 

display-kind

   Specifies a new display kind; OUTPUT, SOURCE and PLOT are the
   valid keywords. OUTPUT indicates a regular output display for the
   SHOW and LIST commands. PLOT indicates a display that holds the
   output of the PLOT or TABULATE command. The SOURCE display holds
   the output from the TYPE command. If you omit the display-kind
   parameter, the kind of the display is not changed.
 

2  Description
   The DISPLAY command performs a variety of functions. Its major
   function is to show the contents of the specified screen
   displays. Each specified display is placed on top of any other
   displays that occupy overlapping windows on the terminal screen.
   The specified displays then become fully visible and any displays
   they overlap are hidden.

   You can also use the DISPLAY command to change the attributes
   of the specified screen displays. You can create displays that
   do not appear on the screen, you can change their sizes, you can
   clear their contents, and you can change their window locations
   and display kinds.
 

2  Qualifiers
 

/CLEAR

   Erases the entire textual contents of the specified screen
   displays.
 

/DYNAMIC

      /DYNAMIC
      /NODYNAMIC

   Controls whether a display automatically adjusts its window
   dimensions proportionally when a SET TERMINAL command is issued.
   /DYNAMIC is the default.
 

/HIDE

   Conceals the display under any other displays that overlap it.
   As a result, any displays that were previously hidden under the
   specified display become visible.
 

/POP

      /POP
      /NOPOP

   /POP places a specified display at the top of the display
   pasteboard, ahead of any other displays. This is the default.
   /NOPOP preserves the order of all displays on the pasteboard.
 

/PUSH

      /PUSH
      /NOPUSH

   /PUSH has the same effect as /HIDE. /NOPUSH preserves the order
   of all displays on the pasteboard (same effect as /NOPOP).
 

/REFRESH

   Refreshes the terminal screen. Do not use parameters or other
   qualifiers on a DISPLAY/REFRESH command.
 

/REMOVE

   Creates a display that does not appear on the screen. Its
   definition and textual contents are saved, and can be brought
   back with another DISPLAY command.
 

/SIZE

      /SIZE:n

   Changes the maximum size of a normal output display to n lines.
   If more than n lines are written to the display, the oldest lines
   are lost as the new lines are added. If you omit this qualifier,
   the maximum size is not changed.
 

2  Examples

 PCAA> DISPLAY PLOT

     This command displays the screen display named PLOT. PLOT is
     placed over any other displays with overlapping windows.

 PCAA> DISPLAY/SIZE:200 OUT

     This command changes the size of the OUT display so that OUT
     holds the 200 most recent lines of output instead of the
     default 100 lines. It also places OUT on top of any other
     displays with overlapping windows.