DEBUG DISPLAY — MicroVMS 4.5B
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 debug command
list.
Format:
DISPLAY [/qualifier...] [disp-name [AT wspec] [dkind]
[, disp-name [AT wspec] [dkind]...]]
Additional information available:
/CLEAR/GENERATE/HIDE/MARK_CHANGE/NOMARK_CHANGE
/POP/NOPOP/PUSH/NOPUSH/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 Clear the display(s)
/GENERATE Regenerate an automatically generated display
/HIDE Hide a display behind all others
/[NO]MARK_CHANGE Specifies whether or not changes should be
/[NO]POP Pop a display to the front of all others
/[NO]PUSH Push a display behind all others
/REFRESH Refresh the entire screen
/REMOVE Remove a display
/SIZE:n Set the size of a display
/CLEAR
Clear the entire contents of the specified screen displays.
/GENERATE
Regenerate the contents of the specified screen displays if those
displays are automatically generated displays.
/HIDE
Hide 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
Mark changed lines of a DO(debug-cmd-list) display 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.
/NOMARK_CHANGE
Do not mark changed lines of a DO(debug-cmd-list) display. 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.
/POP
Pop 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.
/NOPOP
Do 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.
/PUSH
Push 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.
/NOPUSH
Do 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.
/REFRESH
Refresh the terminal screen. If this qualifier is present, no
other parameters may be present on the DISPLAY command.
/REMOVE
Mark the displays as being removed, meaning that they will not be
shown on the terminal screen unless explicitly requested with
later DISPLAY commands. A removed display is not visible on the
screen, but the display and its contents are preserved.
/SIZE:n
Change 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.