CHANGE

Used to change the specification of either the current form or the next form.

Syntax

[CHANGE NFORM TO {[CLEAR
APPEND
FREEZE APPEND] ["formname"fieldnameindexretrieve$RETURN
$HEAD$END
$REFRESH ]}
CHANGE CFORM TO {NOREPEAT
REPEAT
REPEAT APPEND}]

Parameters

NFORM

indicates the next form to be displayed after the current form at execution time.

CFORM

indicates the current form.

CLEAR

indicates that the screen is to be cleared when the next form is displayed.

APPEND

indicates that the next form is to be appended to the current form.

FREEZE APPEND

indicates that the current form is kept on the screen when the next form is appended to it even after the screen is full, at which point the top next form is rolled off the screen.

NOREPEAT

indicates that the current repeating form is to be stopped.

REPEAT

indicates that the current form is to be repeated.

REPEAT APPEND

indicates that the current form is to be repeated and appended to itself.

formname

is the name of any existing form in the forms file.

fieldname

is the name of a character type field that contains a form name.

indexretrieve

is an item in a list of existing form names. It is specified as:

index OF "name" [,"name"]...

where index is an integer, and name is a form name or any 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.

CHANGE

Technical documentation

» Table of Contents

» Index

Syntax

Parameters

Discussion

Example