Selects a screen display as the current error, input,
instruction, output, program, prompt, scrolling, or source
display.
NOTE
This command is not available in the VSI DECwindows Motif for
OpenVMS user interface to the debugger.
Format
SELECT [display-name]
1 – Parameters
display-name
Specifies the display to be selected. You can specify any one
of the following, with the restrictions noted in the qualifier
descriptions:
o A predefined display:
SRC
OUT
PROMPT
INST
REG
FREG (Alpha and Integrity servers only)
IREG
o A display previously created with the DISPLAY command
o A display built-in symbol:
%CURDISP
%CURSCROLL
%NEXTDISP
%NEXTINST
%NEXTOUTPUT
%NEXTSCROLL
%NEXTSOURCE
If you omit this parameter and do not specify a qualifier, you
"unselect" the current scrolling display (no display then has the
scrolling attribute). If you omit this parameter but specify a
qualifier (/INPUT, /SOURCE, and so on), you unselect the current
display with that attribute (see the qualifier descriptions).
2 – Qualifiers
2.1 /ERROR
Selects the specified display as the current error display. This
causes all debugger diagnostic messages to go to that display.
The display specified must be either an output display or the
PROMPT display. If you do not specify a display, this qualifier
selects the PROMPT display current error display. By default, the
PROMPT display has the error attribute.
2.2 /INPUT
Selects the specified display as the current input display. This
causes that display to echo debugger input (which appears in the
PROMPT display). The display specified must be an output display.
If you do not specify a display, the current input display
is unselected and debugger input is not echoed to any display
(debugger input appears only in the PROMPT display). By default,
no display has the input attribute.
2.3 /INSTRUCTION
Selects the specified display as the current instruction display.
This causes the output of all EXAMINE/INSTRUCTION commands to
go to that display. The display specified must be an instruction
display.
If you do not specify a display, the current instruction display
is unselected and no display has the instruction attribute.
By default, for all languages except MACRO-32, no display has the
instruction attribute. If the language is set to MACRO-32, the
INST display has the instruction attribute by default.
2.4 /OUTPUT
Selects the specified display as the current output display. This
causes debugger output that is not already directed to another
display to go to that display. The display specified must be
either an output display or the PROMPT display.
If you do not specify a display, the PROMPT display is selected
as the current output display. By default, the OUT display has
the output attribute.
2.5 /PROGRAM
Selects the specified display as the current program display.
This causes the debugger to try to force program input and
output to that display. Currently, only the PROMPT display can
be specified.
If you do not specify a display, the current program display is
unselected and program input and output are no longer forced to
the specified display.
By default, the PROMPT display has the program attribute, except
on workstations, where the program attribute is unselected.
2.6 /PROMPT
Selects the specified display as the current prompt display.
This is where the debugger prompts for input. Currently, only the
PROMPT display can be specified. Moreover, you cannot unselect
the PROMPT display (the PROMPT display always has the prompt
attribute).
2.7 /SCROLL
(Default) Selects the specified display as the current scrolling
display. This is the default display for the SCROLL, MOVE,
and EXPAND commands. Although any display can have the scroll
attribute, you can use only the MOVE and EXPAND commands (not the
SCROLL command) with the PROMPT display.
If you do not specify a display, the current scrolling display is
unselected and no display has the scroll attribute.
By default, for all languages except MACRO-32, the SRC display
has the scroll attribute. If the language is set to MACRO-32, the
INST display has the scroll attribute by default.
2.8 /SOURCE
Selects the specified display as the current source display. This
causes the output of all TYPE and EXAMINE/SOURCE commands to go
to that display. The display specified must be a source display.
If you do not specify a display, the current source display is
unselected and no display has the source attribute.
By default, for all languages except MACRO-32, the SRC display
has the source attribute. If the language is set to MACRO-32, no
display has the source attribute by default.
3 – Description
Attributes are used to select the current scrolling display
and to direct various types of debugger output to particular
displays. This gives you the option of mixing or isolating
different types of information, such as debugger input, output,
diagnostic messages, and so on in scrollable displays.
Use the SELECT command with one or more qualifiers (/ERROR,
/SOURCE, and so on) to assign one or more corresponding
attributes to a display. By default, if you do not specify a
qualifier, /SCROLL is assumed.
If you use the SELECT command without specifying a display name,
the attribute assignment indicated by the qualifier is canceled
(unselected). To reassign display attributes, you must use
another SELECT command. For more information, see the individual
qualifier.
For a list of the key definitions associated with the SELECT
command, type Help Keypad_Definitions_CI. Also, use the SHOW KEY
command to determine the current key definitions.
Related commands:
DISPLAY
EXPAND
MOVE
SCROLL
SHOW SELECT
4 – Examples
1.DBG> SELECT/SOURCE/SCROLL SRC2
This command selects display SRC2 as the current source and
scrolling display.
2.DBG> SELECT/INPUT/ERROR OUT
This command selects display OUT as the current input and
error display. This causes debugger input, debugger output
(assuming OUT is the current output display), and debugger
diagnostic messages to be logged in the OUT display in the
correct sequence.
3.DBG> SELECT/SOURCE
This command unselects (deletes the source attribute from)
the currently selected source display. The output of a TYPE
or EXAMINE/SOURCE command then goes to the currently selected
output display.