DEBUG SELECT — MicroVMS 4.5B
Causes a screen display to be selected with a specified
attribute. For example, SELECT/SCROLL OUT selects the OUT
display with the "scroll" attribute (attributes are indicated on
the top border of the display). The "scroll" attribute means
that the keypad keys KP2, KP4, KP6, and KP8, will scroll, expand,
or move that display.
Other attributes include:
error - error messages are directed to that display
input - input lines are echoed in the display
output - DEBUG output is written to that display
program - your program's output goes to the display
instruction - EXAM/INST centers the display
source - TYPE or EXAM/SOURCE centers the display
Format:
SELECT [/qualifier...] [disp-name]
You un-select an attribute from a display by omitting the display
name, e.g., "SELECT/INPUT" to remove the input attribute from
whatever display it is on.
Additional information available:
Examples
! Select OUT as the input and error display as well as being
! the output display. This causes debugger input, output, and
! error messages to be intermixed in the scrollable display OUT.
!
DBG> SELECT/INPUT/ERROR OUT
! Select SRC2 as the current source and scrolling display.
!
DBG> SELECT/SOURCE/SCROLL SRC2
! Remove the source attribute from any display. TYPE commands
! then just go to the OUT display.
!
DBG> SELECT/SOURCE
Parameters
disp-name
The name of the screen display to be selected. If this name is
omitted, the current select setting is cancelled.
Qualifiers
Additional information available:
/ERROR/INPUT/INSTRUCTION/OUTPUT/PROGRAM/SCROLL
/SOURCE
/ERROR
Select the specified screen display as the current error display.
This means that debugger error messages are directed to that
display. By default, debugger error messages go to the PROMPT
display, which is not scrollable. If you do "SELECT/ERROR OUT"
then the error messages will start going to the scrollable
display OUT. SELECT/ERROR with no display name will put the
error attribute back on the PROMPT display, which is the default.
Hence, SELECT/ERROR PROMPT and SELECT/ERROR are equivalent.
/INPUT
Select the specified screen display as the current input display.
This means that debugger input lines are echoed in that display.
Note that you are always prompted for input in the PROMPT
display; selecting another display with the input attribute means
that your input lines are also echoed in that other display.
By default, no display is selected with the "input" attribute.
If you do "SELECT/INPUT OUT" then your input lines are echoed in
the scrollable OUT display, i.e., you get your input and debugger
output intermixed in that display. Some people prefer this so
that they can see what input line caused what line of debugger
output.
/INSTRUCTION
Select the specified screen display as the current instruction
display. This means that output of an EXAMINE/INSTRUCTION
command goes to the specified display. The specified display
must be an instruction display in this case.
/OUTPUT
Select the specified screen display as the current output
display. This means that all normal debugger output is directed
to that display. The specified display may not be a source
display or an instruction display in this case. SELECT/OUTPUT
with no display name will put the output attribute on the PROMPT
display. Hence, SELECT/OUTPUT PROMPT and SELECT/OUTPUT are
equivalent.
/PROGRAM
By default, your program's I/O is directed to the PROMPT display.
This is done by setting the scrolling region to that display just
before the debugger returns control to your program. Currently,
SELECT/PROGRAM is very restricted: you cannot give the PROGRAM
attribute to any display other than PROMPT (this restriction may
be removed at a future time). You can say "SELECT/PROGRAM" which
removes the "program" attribute from the PROMPT display. Then
DEBUG will take no special action to redirect your program's I/O
(which may be desirable if your program does no I/O or if you
have explicitly redirected your program's I/O to another
terminal). SELECT/PROGRAM PROMPT puts the "program" attribute
back on the PROMPT display.
Note - on VAXstations, the debugger comes up in a different
window from your program, so there is no need to direct program
I/O to the PROMPT display in this environment. Therefore the
default for VAXstations is for the "program" attribute to be
un-selected.
/SCROLL
Select the specified screen display as the current scrolling
display. This means that the SCROLL command will by default
scroll this display unless a different display is explicitly
specified. The commands EXPAND and MOVE will also manipulate
this display by default. Note, although the PROMPT display may
be selected as the current scrolling display, the PROMPT display
may not be scrolled. It may however be moved and expanded. (See
HELP MOVE and HELP EXPAND for more information).
/SOURCE
Select the specified screen display as the current source
display. This means that the output of all TYPE and EXAMINE
/SOURCE commands go to the specified display. The specified
display must be a source display in this case.