DEBUG DISPLAY — VMS 5.0
Displays a specified screen display or list of screen displays on
the terminal screen. With the proper qualifiers, this command
can also be used to remove displays from the screen or to refresh
the entire screen contents. Normally, the DISPLAY command is
used to display a screen display on top of any other displays
that occupy the same window on the terminal screen. It makes the
specified display fully visible. However, this command can also
be used to change the display's screen window, to change its
maximum size in lines, or to change its kind or command list.
Format:
DISPLAY [/qualifier...] [disp-name [AT wspec] [dkind]
[, disp-name [AT wspec] [dkind]...]]
Additional information available:
/CLEAR/DYNAMIC/GENERATE/HIDE/MARK_CHANGE
/NODYNAMIC/NOMARK_CHANGE/NOPOP/NOPUSH/POP
/PUSH/REFRESH/REMOVE/SIZE:n
Examples
! Put the source display at the top half and the output display
! at the bottom half of the screen.
!
DBG> DISPLAY SRC AT H1; DISPLAY OUT AT H2
! Put the source display about in the middle of the screen.
! Starting at line 4, 8 lines long and starting at column 20,
! 30 columns wide.
!
DBG> DISP SRC AT (4,8,20,30)
! Remove the instruction display.
!
DBG> DISP/REMOVE INST
! Refresh the screen.
!
DBG> DISP/REFRESH
Parameters
disp-name
The name of the screen display to be displayed.
wspec
The name of the screen window at which this display is to be
positioned if the position is being changed. This may also be a
window specification of the form (start-line, line-count,
start-column, column-count). If wspec is omitted, the display's
screen position is not changed.
dkind
The new display kind, if the kind is being changed. This
parameter can have the same values as on the SET DISPLAY command:
OUTPUT, SOURCE, SOURCE (debug-cmd-list), INSTRUCTION,
INSTRUCTION(debug-cmd-list), DO (debug-cmd-list), or REGISTER.
Qualifiers
/CLEAR Clears the display(s)
/[NO]DYNAMIC Automatically adjusts the display window
/GENERATE Regenerates an automatically generated display
/HIDE Hides a display behind all others
/[NO]MARK_CHANGE Highlights changes
/[NO]POP Pops a display to the front of all others
/[NO]PUSH Pushes a display behind all others
/REFRESH Refreshes the entire screen
/REMOVE Removes a display
/SIZE:n Sets the size of a display
/CLEAR
Clears the entire contents of the specified screen displays.
/DYNAMIC
Specifies that the display is to automatically adjust its window
dimensions proportionally when you change the screen height or
width with a SET TERMINAL command. This is the default behavior
for all displays.
/GENERATE
Regenerates the contents of the specified screen displays if
those displays are automatically generated displays.
/HIDE
Hides the specified screen displays under any other displays that
occupy the same region on the terminal screen. The effect is to
make visible any displays that were occluded by the specified
displays. This has the same effect as the /PUSH qualifier.
/MARK_CHANGE
Specifies that any changed lines of a DO(debug-cmd-list) display
are marked each time the display is automatically updated. The
marking is done by highlighting each line of the display which
has a different textual content this time compared to the last
time the display was updated. This qualifier is useful when you
want changed variables in an automatically updated display to be
highlighted on change. This qualifier is not applicable to other
kinds of displays.
/NODYNAMIC
Specifies that a display is not to automatically adjust its
window dimensions when you change the screen height or width with
a SET TERMINAL command.
/NOMARK_CHANGE
Specifies that changed lines of a DO(debug-cmd-list) display are
not marked when the display is automatically updated. This
qualifier cancels the effect of an earlier /MARK_CHANGE qualifier
for the specified displays. This qualifier is not applicable to
other kinds of displays.
/NOPOP
Does not pop the specified screen displays to the front of the
other displays. This qualifier preserves the pasting order of
all the displays. This has the same effect as the /NOPUSH
qualifier.
/NOPUSH
Does not push or hide the specified screen displays under any
other displays. This qualifier preserves the pasting order of
all the displays. This has the same effect as the /NOPOP
qualifier.
/POP
Pops the specified screen displays to the front of all other
displays that occupy the same region on the terminal screen.
This is the default action of the DISPLAY command.
/PUSH
Pushes the specified screen displays under any other displays
that occupy the same region on the terminal screen. The effect
is to make visible any displays that were occluded by the
specified displays. This has the same effect as the /HIDE
qualifier.
/REFRESH
Refreshes the terminal screen. If you specify this qualifier, do
not specify command parameters.
/REMOVE
Marks the specified display as being removed. A removed display
does not appear on the screen unless explicitly requested with a
later DISPLAY command. Although a removed display is not visible
on the screen, the display and its contents are preserved.
/SIZE:n
Changes the maximum size of the display to be n lines of text.
If more than n lines are written to the display, the oldest lines
are lost as new lines are added. If this qualifier is omitted,
the maximum size is not changed.