DBG$HELP.HLB  —  DEBUG  DISPLAY  Parameters
 display-name

    Specifies the display to be created or modified.

    If you are creating a new display, specify a name that is not
    already used as a display name.

    If you are modifying an existing display, you can specify any of
    the following entities:

    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

    You must specify a display unless you use /GENERATE (parameter
    optional), or /REFRESH (parameter not allowed).

    You can specify more than one display, each with an optional
    window specification and display kind.

 window-spec

    Specifies the screen window at which the display is to be
    positioned. You can specify any of the following entities:

    o  A predefined window. For example, RH1 (right top half).

    o  A window definition previously established with the SET WINDOW
       command.

    o  A window specification of the form (start-line, line-count[,
       start-column, column-count]). The specification can include
       expressions which can be based on the built-in symbols %PAGE
       and %WIDTH (for example, %WIDTH/4).

    If you omit the window specification, the screen position depends
    on whether you are specifying an existing display or a new
    display:

    o  If you are specifying an existing display, the position of the
       display is not changed.

    o  If you are specifying a new display, it is positioned at
       window H1 or H2, alternating between H1 and H2 each time you
       create another display.

 display-kind

    Specifies the display kind. Valid keywords are as follows:

    DO                  Specifies an automatically updated output
    (command[; . . . ]) display. The commands are executed in the
                        order listed each time the debugger gains
                        control. Their output forms the contents of
                        the display. If you specify more than one
                        command, the commands must be separated by
                        semicolons.
    INSTRUCTION         Specifies an instruction display. If selected
                        as the current instruction display with the
                        SELECT/INSTRUCTION command, it displays the
                        output from subsequent EXAMINE/INSTRUCTION
                        commands.
    OUTPUT              Specifies an output display. If selected
                        as the current output display with the
                        SELECT/OUTPUT command, it displays any
                        debugger output that is not directed to
                        another display. If selected as the current
                        input display with the SELECT/INPUT command,
                        it echoes debugger input. If selected as the
                        current error display with the SELECT/ERROR
                        command, it displays debugger diagnostic
                        messages.
    REGISTER            Specifies an automatically updated register
                        display. The display is updated each time the
                        debugger gains control.
    SOURCE              Specifies a source display. If selected
                        as the current source display with the
                        SELECT/SOURCE command, it displays the
                        output from subsequent TYPE or EXAMINE/SOURCE
                        commands.
    SOURCE (command)    Specifies an automatically updated source
                        display. The command specified must be a
                        TYPE or EXAMINE/SOURCE command. The source
                        display is updated each time the debugger
                        gains control.

    You cannot change the display kind of the PROMPT display.

    If you omit the display-kind parameter, the display kind depends
    on whether you are specifying an existing display or a new
    display:

    o  If you specify an existing display, the display kind is not
       changed.

    o  If you specify a new display, an OUTPUT display is created.
Close Help