%DISPLAY Statement

Displays a macro window.

Type:	Macro statement
Restriction:	Allowed in macro definitions or open code
See:	%WINDOW Statement

Syntax

Details

Syntax

%DISPLAY window<.group> <NOINPUT> <BLANK>
<BELL> <DELETE> ;

Required Arguments

window <.group>: names the window and group of fields to be displayed. If the window has more than one group of fields, give the complete window.group specification. If a window contains a single unnamed group, specify only window.

NOINPUT: specifies that you cannot input values into fields displayed in the window. If you omit the NOINPUT option, you can input values into unprotected fields displayed in the window. Use the NOINPUT option when the %DISPLAY statement is inside a macro definition and you want to merge more than one group of fields into a single display. Using NOINPUT in a particular %DISPLAY statement causes the group displayed to remain visible when later groups are displayed.

BLANK: clears the display in the window. Use the BLANK option to prevent fields from a previous display from appearing in the current display. This option is useful only when the %DISPLAY statement is inside a macro definition and when it is part of a window.group specification. When the %DISPLAY statement is outside a macro definition, the display in the window is cleared automatically after the execution of each %DISPLAY statement.

BELL: rings your personal computer's bell, if available, when the window is displayed.

DELETE: deletes the display of the window after processing passes from the %DISPLAY statement on which the option appears. DELETE is useful only when the %DISPLAY statement is inside a macro definition.

Details

You can display only one group of fields in each execution of a %DISPLAY statement. If you display a window containing any unprotected fields, enter values into any required fields and press ENTER to remove the display from the window.

If a window contains only protected fields, pressing ENTER removes the display from the window. While a window is displayed, you can use commands and function keys to view other windows, change the size of the current window, and so on.