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).