/sys$common/syshlp/DBG$HELP.HLB  —  DEBUG  SET  WINDOW
    Creates a screen window definition. This command is not available
    in the VSI DECwindows Motif for OpenVMS user interface to the
    debugger.

    Format

      SET WINDOW  window-name

                  AT (start-line,line-count

                  [,start-column,column-count])

1  –  Parameters

 window-name

    Specifies the name of the window you are defining. If a window
    definition with that name already exists, it is canceled in favor
    of the new definition.

 start-line

    Specifies the starting line number of the window. This line
    displays the window title, or header line. The top line of the
    screen is line 1.

 line-count

    Specifies the number of text lines in the window, not counting
    the header line. The value must be at least 1. The sum of start-
    line and line-count must not exceed the current screen height.

 start-column

    Specifies the starting column number of the window. This is the
    column at which the first character of the window is displayed.
    The leftmost column of the screen is column 1.

 column-count

    Specifies the number of characters per line in the window. The
    value must be at least 1. The sum of start-column and column-
    count must not exceed the current screen width.

2  –  Description

    A screen window is a rectangular region on the terminal screen
    through which you can view a display. The SET WINDOW command
    establishes a window definition by associating a window name
    with a screen region. You specify the screen region in terms of a
    starting line and height (line count) and, optionally, a starting
    column and width (column count). If you do not specify the
    starting column and column count, the starting column defaults
    to column 1 and the column count defaults to the current screen
    width.

    You can specify a window region in terms of expressions that use
    the built-in symbols %PAGE and %WIDTH.

    You can use the names of any windows you have defined with the
    SET WINDOW command in a DISPLAY command to position displays on
    the screen.

    Window definitions are dynamic-that is, window dimensions expand
    and contract proportionally when a SET TERMINAL command changes
    the screen width or height.

    Related commands:

       DISPLAY
       (SHOW,CANCEL) DISPLAY
       (SET,SHOW) TERMINAL
       (SHOW,CANCEL) WINDOW

3  –  Examples

    1.DBG> SET WINDOW ONELINE AT (1,1)

      This command defines a window named ONELINE at the top of the
      screen. The window is one line deep and, by default, spans the
      width of the screen.

    2.DBG> SET WINDOW MIDDLE AT (9,4,30,20)

      This command defines a window named MIDDLE at the middle of the
      screen. The window is 4 lines deep starting at line 9, and 20
      columns wide starting at column 30.

    3.DBG> SET WINDOW FLEX AT (%PAGE/4,%PAGE/2,%WIDTH/4,%WIDTH/2)

      This command defines a window named FLEX that occupies a region
      around the middle of the screen and is defined in terms of the
      current screen height (%PAGE) and width (%WIDTH).
Close Help