DBG$HELP.HLB  —  DEBUG  EXPAND
    Expands or contracts the window associated with a screen display.

                                   NOTE

       This command is not available in the VSI DECwindows Motif for
       OpenVMS user interface to the debugger.

    Format

      EXPAND  [display-name[, . . . ]]

1  –  Parameters

 display-name

    Specifies a display to be expanded or contracted. 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

    If you do not specify a display, the current scrolling display,
    as established by the SELECT command, is chosen.

2  –  Qualifiers

2.1    /DOWN

       /DOWN[:n]

    Moves the bottom border of the display down by n lines (if n is
    positive) or up by n lines (if n is negative). If you omit n, the
    border is moved down by 1 line.

2.2    /LEFT

       /LEFT[:n]

    Moves the left border of the display to the left by n lines (if
    n is positive) or to the right by n lines (if n is negative). If
    you omit n, the border is moved to the left by 1 line.

2.3    /RIGHT

       /RIGHT[:n]

    Moves the right border of the display to the right by n lines (if
    n is positive) or to the left by n lines (if n is negative). If
    you omit n, the border is moved to the right by 1 line.

2.4    /UP

       /UP[:n]

    Moves the top border of the display up by n lines (if n is
    positive) or down by n lines (if n is negative). If you omit
    n, the border is moved up by 1 line.

3  –  Description

    You must specify at least one qualifier.

    The EXPAND command moves one or more display-window borders
    according to the qualifiers specified (/UP:[n], /DOWN:[n],
    RIGHT:[n], /LEFT:[n]).

    The EXPAND command does not affect the order of a display on
    the display pasteboard. Depending on the relative order of
    displays, the EXPAND command can cause the specified display to
    hide or uncover another display or be hidden by another display,
    partially or totally.

    Except for the PROMPT display, any display can be contracted to
    the point where it disappears (at which point it is marked as
    "removed"). It can then be expanded from that point. Contracting
    a display to the point where it disappears causes it to lose any
    attributes that were selected for it. The PROMPT display cannot
    be contracted or expanded horizontally but can be contracted
    vertically to a height of 2 lines.

    A window border can be expanded only up to the edge of the
    screen. The left and top window borders cannot be expanded beyond
    the left and top edges of the display, respectively. The right
    border can be expanded up to 255 columns from the left display
    edge. The bottom border of a source or instruction display can
    be expanded down only to the bottom edge of the display (to the
    end of the source module or routine's instructions). A register
    display cannot be expanded beyond its full size.

    For a list of the key definitions associated with the EXPAND
    command, type Help Keypad_Definitions_CI. Also, use the SHOW KEY
    command to determine the current key definitions.

    Related commands:

       DISPLAY
       MOVE
       SELECT/SCROLL
       (SET,SHOW) TERMINAL

4  –  Examples

    1.DBG> EXPAND/RIGHT:6

      This command moves the right border of the current scrolling
      display to the right by 6 columns.

    2.DBG> EXPAND/UP/RIGHT:-12 OUT2

      This command moves the top border of display OUT2 up by 1 line,
      and the right border to the left by 12 columns.

    3.DBG> EXPAND/DOWN:99 SRC

      This command moves the bottom border of display SRC down to the
      bottom edge of the screen.
Close Help