DEBUG EXPAND — VMS 5.1-B
Expands or contracts the window associated with a screen display.
The EXPAND command moves one or more display-window borders
according to the qualifier(s) specified (/UP, /DOWN, RIGHT,
/LEFT). For example, the following command moves the right
border of display SRC four columns to the right, and the bottom
border six lines up:
EXPAND/RIGHT:4/DOWN:-6 SRC
The EXPAND command does not affect the order of a display in the
pasteboard circular list. Depending on the relative order of
displays, the EXPAND command may 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 shrunk down to
the point where it disappears (at which point it is marked as
"removed"). It can then be expanded from that point. The PROMPT
display cannot be shrunk (or expanded) horizontally, but can be
shrunk vertically to a height of 2 lines. Contracting a display
to the point where it disappears will cause it to lose any
attributes that were selected for it.
A window border can be expanded only up to the edge of the
screen. Thus, specifying EXPAND/DOWN:99 SRC lowers the bottom
border of display SRC to the bottom 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 (last
line of the source module or last instruction of the routine). A
register display cannot be expanded beyond its full size.
In the case of an OUTPUT or DO display, the scrolling region
preserved in memory extends to 64 lines by default but may be
increased or decreased through the /SIZE qualifier with the
DISPLAY and SET DISPLAY commands.
Format:
EXPAND /qualifier[...] [disp_name [,disp_name...] ]
Additional information available:
ExamplesKey DefinitionsParametersQualifiers
Examples
DBG> EXPAND/DOWN:99 FOO ! Move the bottom border of display FOO
! down to the bottom edge of the screen
DBG> EXPAND/UP/RIGHT:-6 ! Move the top border of the current
! scrolling display up by 1 line, and
! the right border to the left by
! 6 columns.
Key Definitions
Several keypad keys have been bound to the EXPAND and MOVE
commands, to facilitate expanding, contracting, and moving
displays. (See HELP KEYPAD STATE_KEYS for more information).
Parameters
disp_name
The name (or list of names) of the screen display(s) to be
expanded or shrunk. If this name is omitted, the current
selected scrolling display is used. (See HELP SELECT/SCROLL).
Qualifiers
Additional information available:
/DOWN[:n]
Move the bottom border of the display down by n lines (if n is
positive) or up by n lines (if n is negative). If n is omitted,
the border is moved down by 1 line. See the EXPAND command
description for restrictions.
/LEFT[:n]
Move 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 n
is omitted, the border is moved to the left by 1 line. See the
EXPAND command description for restrictions.
/RIGHT[:n]
Move 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
n is omitted, the border is moved to the right by 1 line. See
the EXPAND command description for restrictions.
/UP[:n]
Move the top border of the display up by n lines (if n is
positive) or down by n lines (if n is negative). If n is
omitted, the border is moved up by 1 line. See the EXPAND
command description for restrictions.