DEBUG SELECT — VMS FORTRAN_5.2
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, 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 - debugger 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, for example, "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/SUFFIX
/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 go to the scrollable display OUT.
SELECT/ERROR with no display name puts 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 enter the comand "SELECT/INPUT OUT" then your input lines
are echoed in the scrollable OUT display. That is, your input
and debugger output are 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 puts 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 enter the command
SELECT/PROGRAM which removes the "program" attribute from the
PROMPT display. Then the debugger takes 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 by default scrolls
this display unless a different display is explicitly specified.
The commands EXPAND and MOVE 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.
/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).