5 Controlling Forms

The STORE FORM Statement

The STORE FORM statement is only available in the development version of Eloquence. This statement stores a form that has been loaded using the LOAD FORM statement. Syntax is as follows:

STORE FORM "form name [volume spec]", array

Replace form name with the name of the form. The form name can be up to nine characters long; the extension .FORM is automatically appended to the form name. The volume spec parameter is optional. If used, replace it with the volume label or unit specifier. Replace array with an integer array name. This array will contain the information about the fields of the form. The minimum array size (number of elements in the array) is equal to 7 + 2 $\ast$ number of input fields + number of output fields. So, if you have 50 input fields and 70 output fields, the array associated with the form must allow for at least 177 elements.

A form can be stored back to its LOADed name or to a new form name using the STORE FORM command.

It is possible to store default values in the fields of a form. To do so, load the form (LOAD FORM), type information into the desired fields, and store the form (STORE FORM). Now when GET FORM is executed the information previously typed in and stored appears in the form on the screen.

Error Messages

The error messages mentioned under page 50 also apply to STORE FORM. However, there is one additional message unique to STORE FORM. It is as follows:

ERROR 863 - Inconsistant information given.

This message occurs if you update the forms image without updating the array elements or vice versa.

Eloquence Forms Manual - 19 DEC 2002