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

272 Chapter6
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
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.