HP 3000 Manuals HP 3000 Manuals
VFINISHFORM
Performs any processing specifications defined for the final phase of
fields editing.
Syntax
VFINISHFORM {comarea}
Parameters
comarea Must be comarea name specified when the forms file was
opened with VOPENFORMF. If not already set, the
following comarea items must be set before calling
VFINISHFORM:
cstatus Set to zero.
comarealen Set to total number of two-byte words
in comarea.
VFINISHFORM may set the following comarea items:
cstatus Set to nonzero value if call
unsuccessful.
numerrs Set to total number of fields in the
form in which errors were detected.
nfname Set to name of next form if processing
specifications altered form name.
repeatapp Set to new repeat code if processing
specifications altered code.
freezapp Set to new next form code if processing
specifications altered code.
Discussion
All special processing defined as part of the "finish" phase of field
editing is performed by this intrinsic. Altering the next form to be
displayed is a typical finish operation, and updating a save field is
another. (Refer to the discussion of phases in Section 4.)
Like VFIELDEDITS, VFINISHFORM sets an error flag for each field that has
an error as a result of processing the form. (Refer to the VFIELDEDITS
discussion.)
Example
COBOL
CALL "VFINISHFORM" USING COMAREA.
BASIC
160 CALL VFINISHFORM(C(*))
FORTRAN
CALL VFINISHFORM(COMAREA)
SPL/PASCAL
VFINISHFORM(COMAREA);
The examples above perform all finish operations on a form.