HP Data Entry and Forms Management System (VPLUS) Reference Manual (32209-90024)

170 Chapter4
Advanced Forms Design
CHANGE
field or save field whose value is a form name. The name
must identify an existing form.
$RETURN indicates the last different form displayed before the
current form at execution time.
$HEAD indicates the first form displayed at execution time.
$END indicates to ENTRY or an application that the current
form is the last form to be displayed.
$REFRESH indicates that current form is to be refreshed (cleared of
entered data) and displayed as the next form.
Discussion
This statement may be entered in a processing specification for any field in the form. It
causes the specified changes to the current or next form to take effect when the next form
is requested, and it causes the specified next form to be displayed when the current form is
finished at execution time.
If several NFORM statements are specified in a form, only the last statement executed is
effective.
When forms sequence is defined in the Form Menu (refer to Section 3), the current form
may be repeated, or repeated and appended to itself, or neither, when the next form is
requested. Also, the current form may be cleared when the next form is requested, or it
may remain on the screen with the next form appended to it. The CHANGE statement allows
you to alter these form specifications dynamically.
Additionally, the CHANGE statement allows you to specify a different next form than the one
specified on the Form Menu. Note that the form changes do not occur when the field is
entered with the ENTER statement, but only after the current form has been finished.
Example
CHANGE NFORM TO CNT OF "FORM3", "FORM4", "FORM5", "FORM6""FORM7"
Depending on the current value of field CNT, the next form displayed is one
of the forms in the list. For instance, if CNT is 3, FORM5 is the next form.
CHANGE NFORM TO $END
After this form is finished, no more forms will be displayed.
CHANGE NFORM TO APEND "FB"
The next form, FB, is to be appended to the current form.