PCA Command

    Creates new screen displays to be shown on the terminal screen.

    Format

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

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

1  –  Parameters

 display-name

    Specifies the name of a new screen display to create. The display
    name must consist of letters, digits, underscores, and dollar
    signs. It cannot begin with a digit.

 window-spec

    Specifies the screen window at which to position the new display.
    If you omit window-spec, the display is positioned at window H1
    or H2 (H1 and H2 are used alternately, starting with H1).

    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 the kind of display to create; OUTPUT, PLOT and SOURCE
    are the valid keywords. OUTPUT indicates a regular output display
    to hold the output of SHOW, LIST and SEARCH commands. PLOT
    indicates a display to contain the output of PLOT and TABULATE
    commands. SOURCE indicates a display to contain output from a
    TYPE command. If you omit the display-kind parameter, an output
    display is created.

2  –  Description

    The SET DISPLAY command creates new screen displays so that more
    displays than the default PLOT, OUT, SRC and PROMPT displays
    may appear on your terminal screen. By defining multiple plot
    displays and selecting each one in turn as the current plot
    display, you can simultaneously display several different
    histograms or tables on the screen. Similarly, you can create
    multiple output displays.

3  –  Qualifiers

3.1    /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.2    /HIDE

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

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

3.4    /PUSH

    Has the same effect as /HIDE.

3.5    /REMOVE

    Creates a display that does not appear on the screen. Although
    a removed display is not visible on the screen, its definition
    still exists, and you can request that it be displayed by using
    the DISPLAY command.

3.6    /SIZE

       /SIZE:n

    Sets the maximum size of a normal output display to be 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 set to 50 lines.

    For plot displays, n specifies the number of lines of PLOT or
    TABULATE output to be buffered internally by the Analyzer at one
    time. There is usually no need to change this number.

4  –  Examples

  PCAA> SET WINDOW TOP AT (1,8,45,30)
  PCAA> SET DISPLAY NEWINST AT TOP PLOT
  PCAA> SELECT/PLOT NEWINST

      The SET WINDOW command creates a window named TOP starting
      at line 1, column 45, and extending down for 8 lines and to
      the right for 30 columns. The SET DISPLAY command creates an
      instruction display named NEWINST to be displayed through TOP.
      The SELECT/PLOT command selects NEWINST as the current PLOT
      display.

  PCAA> SET DISPLAY/SIZE:500 PING AT T1
  PCAA> SELECT/OUTPUT PING
  PCAA> LIST ALL

      This SET DISPLAY command creates an output display named PING,
      which is placed at window T1, the top third of the screen. PING
      holds up to 500 lines of output. The SELECT command selects
      PING as the current output display. The output of the LIST
      command is written to PING.

  PCAA> SET DISPLAY PANG AT H1 PLOT
  PCAA> SELECT/PLOT/SCROLL PANG
  PCAA> PLOT MODULE FOO BY LINE
  PCAA> SCROLL/DOWN

      The SET DISPLAY command creates a plot display to be shown
      at window H1, the top half of the screen. The SELECT command
      selects that display as the current plot display and as the
      current scrolling display. The output of the PLOT command is
      shown in the PANG display and the SCROLL command scrolls that
      same display. By creating new plot displays, you can see the
      output from several PLOT or TABULATE commands at the same time,
      each in its own screen display.

  PCAA> SET DISPLAY TINY AT (1,2)

      This command creates an output display named TINY. TINY is
      placed at a screen window that starts at line 1 (the top line
      of the screen) and contains two lines of text.