NET/MASTER Network Control Language (NCL) Reference Manual

&SYS.WINDOW.ROWS
System Variables
5–110 106126 Tandem Computers Incorporated
&SYS.WINDOW.ROWS The &SYS.WINDOW.ROWS system variable contains the number of rows available in
the current window and should be used when developing procedures that may be
executed in OCS windows of different sizes.
The system supports split screen operation with a maximum of two operational
windows. &SYS.WINDOW.ROWS is useful when using split screen operation, and
the number of display lines available to the procedure is less than the physical number
for the full screen.
&SYS.WINDOW.ROWS
Considerations
It is good practice to write procedures that accommodate the largest window size
but that automatically adjust for a smaller screen. This variable can be tested to
determine the number of display lines available to a processing window.
When using &SYS.WINDOW.ROWS, the NCL procedure must allow for any fixed
overhead associated with a particular panel. For example, a panel may have a title
on the top, followed by a line of column headings, and a blank third line. Data
then begins on the fourth line of the panel. The procedure must therefore allow
for these three lines before attempting to calculate the number of display lines
available for data.
After subtracting fixed panel overhead from &SYS.WINDOW.ROWS, the NCL
procedure must provide for this system variable having a value as low as 1. This
is the case when operating in split screen mode in which only a single line is
allocated to the window.
If referred to in a background environment, &SYS.WINDOW.ROWS is 0 (zero).
See also &SYS.TERM.COLS, &SYS.TERM.ROWS, and &SYS.WINDOW.COLS.
The dimensions of the physical terminal (regardless of the window dimensions)
can be determined from &SYS.TERM.COLS and &SYS.TERM.ROWS.
&SYS.WINDOW.COLS contains the number of columns currently available.
Example
In the following example, the &SYS.WINDOW.ROWS system variable is tested to
determine if it is large enough for the display of some panel (not shown):
IF &CNT > &SYS.WINDOW.ROWS THEN
SAY "NOT ENOUGH ROWS"