Defining the position of reserved lines

The OPTIONS element LINE defines position of dedicated screen lines.

Syntax

OPTIONS
{ MENU LINE line-value
| MESSAGE LINE line-value
| COMMENT LINE {OFF|line-value}
| PROMPT LINE line-value
| ERROR LINE line-value
| FORM LINE line-value
}

Usage

The OPTIONS statement can define the positions of reserved lines for menus, forms and messages. Reserved window lines are used in TUI mode. These options are not required in GUI mode, as most have no effect on the display, except when using the traditional mode, where program windows are rendered as in a dumb terminal.

COMMENT LINE specifies the position of the comment line. The comment line displays messages defined with the COMMENT attribute in the form specification file. The default is (LAST-1) for the SCREEN, and LAST for all other windows. You can hide the comment line with COMMENT LINE OFF.
ERROR LINE specifies the position on the screen of the error line that displays the text of the ERROR statement. The default is the LAST line of the SCREEN window.
FORM LINE specifies the window line where forms are displayed. The default is (FIRST+2), or line 3 of the current window.
MENU LINE specifies the position of the menu line. This line displays the menu name and options, as defined by the MENU statement. The default is the FIRST line in the window.
MESSAGE LINE specifies the position of the message line. This reserved line displays the text of the MESSAGE statement. The default is (FIRST+1), or line 2 of the current window.
PROMPT LINE specifies the position of the prompt line where the text of PROMPT statements is displayed. The default value is the FIRST line in the window.

You can specify any of the following positions for each reserved line:

Table 1. Reserved line expressions
Expression	Description
`FIRST`	The first line of the screen or window.
`FIRST + integer`	A relative line position from the first line.
`integer`	An absolute line position in the screen or window.
`LAST - integer`	A relative line position from the last line.
`LAST`	The last line of the screen or window.