FILL displays the form associated with the given form ID and prompts for data input. This is also referred to as the form operation. The input data is stored into the field right after the cursor leaves the field.
The FILL statement/command terminates when the key defined in @END_CODE or @CANCEL_CODE is typed. When the execution of the FILL statement/command is terminated, the form disappears from the screen unless the form has been pasted on the screen prior to the execution of the FILL statement/command.
FILL form_id FOR {ENTER, CHANGE, SHOW, CHOICE} KEEP [{IF; UNLESS} clause] [iterate_clause]
|
form_id |
is an integer field that contains the form ID returned by GENERATE. This field can be a valid user-defined field, a Global Storage (GS) field, or a system field. |
|
KEEP |
retains the window on the screen after the statement is executed. This saves from having to paste the window before the next MENU/FILL statement. It avoid the process of paint/clear/repaint. |
FILL @INTEGER FOR ENTER
This statement/command replaces all the fields in the form @INTEGER with the display type of DEFAULT by ENTER and displays the form on the screen if it is not already displayed on the screen. The cursor is then moved to the first ENTER field and the form operation begins.
NOTE: FILL screen processing only rewrites the altered parts of a form (vs. the whole form) for faster development. The alterations are made without refilling the form. There is no need for the screen to be cleared before the altered form is pasted.
SEE ALSO: @FILL_ACTION, @NEXT_ITEM, @CANCEL_CODE, @END_CODE, @HELP_CODE, @REFRESH_CODE, @TERM_CODE, @TERM_LIST, and System Fields (later in this section).