PCA$HELP.HLB  —  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

1  –  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.

3  –  Qualifiers

3.1    /CLEAR 

    Erases the entire textual contents of the specified screen
    displays.

3.2    /DYNAMIC 

       /DYNAMIC
       /NODYNAMIC

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

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

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

3.5    /PUSH 

       /PUSH
       /NOPUSH

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

3.6    /REFRESH 

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

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

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

4  –  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.
Close Help