DBG$HELP.HLB  —  DEBUG  SELECT
    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.
Close Help