Previous Topic: &ZREMIPP

Next Topic: &ZSCOPE


&ZROWS

Indicates the number of rows available to the physical terminal.

NCL procedures might want to determine the number of rows (or lines) associated with the physical terminal. &LUROWS will return the number of lines in the current processing window. However, when operating in split screen mode, this might differ from the number of rows available on the actual screen. &ZROWS is the maximum number of rows available at the terminal regardless of the current processing window size.

While it is good practice to write procedures that cater for the largest screen size (for example: 62 lines for a 3290) and that automatically adjust if used on a smaller screen, it might offer performance advantages to format output to suit the maximum size required for the requesting terminal. This allows the terminal operator to alter screen dimensions as necessary, but also eliminates the formatting of unnecessary data.

Example: &ZROWS

& IF &CNT GT &ZROWS &THEN +
  &GOTO .NOMORE

Note: When processing with an LU1 type device, a value of 1 is returned. For VDU(screen) type devices, a value of 1 to 62 is returned. If tested from a procedure running under a system region, a value of 1 is returned. Therefore, &ZROWS always returns a value between 1 and 62.

More information:

&LUROWS

&ZCOLS