HP 3000 Manuals HP 3000 Manuals
CHANGE
Used to change the specification of either the current form or the next
form.
Syntax
{ ["formname" ]}
{ [fieldname ]}
{[CLEAR ][indexretrieve]}
CHANGE NFORM TO{[APPEND ][$RETURN ]}
{[FREEZE APPEND][$HEAD ]}
{ [$END ]}
{ [$REFRESH ]}
{NOREPEAT }
CHANGE CFORM TO{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 Depending on the current value of field CNT,
"FORM3", "FORM4", "FORM5", "FORM6" the next form displayed is one of the forms in
"FORM7" 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.