DEBUG DISPLAY — VMS FORTRAN_5.2
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:
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
! Make display OUT_X specific to the visible process (process 2)
! and put the display at window S4.
!
DBG_2> DISPLAY/PROCESS OUT_X AT S4
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
Additional information available:
/CLEAR/DYNAMIC/GENERATE/HIDE/MARK_CHANGE
/NODYNAMIC/NOMARK_CHANGE/NOPOP/NOPROCESS
/NOPUSH/POP/PROCESS/PUSH/REFRESH/REMOVE/SIZE:n
/SUFFIX
/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.
/NOPROCESS
Note: This qualifier applies to a multiprocess debugging
configuration (when DBG$PROCESS has the value MULTIPROCESS).
Causes the specified display to always be associated with the
visible process, which may change during program execution. This
is the default behavior.
/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.
/PROCESS[=(process-spec)]
Note: This qualifier applies to a multiprocess debugging
configuration (when DBG$PROCESS has the value MULTIPROCESS).
Causes the specified display to be process specific -- that is,
the specified display is associated only with a particular
process. The contents of a process-specific display are
generated and modified in the context of that process. You can
make any display process specific, except for the PROMPT display.
/PROCESS=(process-spec) causes the specified display to be
associated with the specified process. You must include the
parentheses. Use any of the following process-spec forms:
[%PROCESS_NAME] process-name The VMS process name, if that
name contains no spaces or
lowercase characters[1].
[%PROCESS_NAME] "process-name" The VMS process name, if that
name contains spaces or lowercase
characters. You can also use
apostrophes (') instead of
quotation marks (").
%PROCESS_PID process_id The VMS process identification
number (PID, a hexadecimal number).
%PROCESS_NUMBER process-number The number assigned to a process
(or %PROC process-number) when it comes under debugger control.
Process numbers appear in a
SHOW PROCESS display.
process-group-name A symbol defined with the
DEFINE/PROCESS_GROUP command to
represent a group of processes.
%NEXT_PROCESS The next process in the debugger's
circular process list after the
visible process.
%PREVIOUS_PROCESS The previous process in the
debugger's circular process list
before the visible process.
%VISIBLE_PROCESS The process whose stack, register
set, and images are the current
context for looking up symbols,
register values, routine calls,
breakpoints, and so on.
_______________________________________________________
[1]The process name can include the asterisk wildcard
character (*)
/PROCESS causes the specified display to be associated with the
process that was the visible process when the DISPLAY/PROCESS
command was executed. If you do not specify /PROCESS, the
current process-specific behavior (if any) of the specified
display remains unchanged. See also /SUFFIX.
/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.
/SUFFIX[=process-identifier-type]
Note: This qualifier applies to a multiprocess debugging
configuration (when DBG$PROCESS has the value MULTIPROCESS). Use
this qualifier only directly after a display name.
Appends a process-identifying suffix to a display name. The
suffix denotes the visible process. This qualifier is used
primarily in command procedures when specifying display
definitions or key definitions that are bound to display
definitions. Use any of the following process-identifier-type
keywords:
PROCESS_NAME The display-name suffix is the VMS process name.
PROCESS_NUMBER The display-name suffix is the process number
(as shown in a SHOW PROCESS display).
PROCESS_PID The display-name suffix is the VMS process
identification number (PID).
If you specify /SUFFIX without a process-identifier- type
keyword, the process identifier type used for the display-name
suffix is, by default, the same as that used for the prompt
suffix (see SET PROMPT/SUFFIX). See also /[NO]PROCESS.