HP Data Entry and Forms Management System (VPLUS) Reference Manual (32209-90024)
294 Chapter6
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
Discussion below for more information.
repeatapp
Set to value read from forms file for this (current) form.
freezapp
Set to value read from forms file for this (current) form.
dbuflen
Set to length (in bytes) of the current form just read from
the forms file.
Discussion
VGETNEXTFORM checks the value of
repeatapp
passed in
comarea
. If this value indicates
the current form is to be repeated, or repeated and appended to itself, it does not read the
next form, nor does it update the values of
cfnumlines
,
nfname
,
repeatapp
,
freezapp
, or
dbuflen
. Note that a repeating form is repeated until repeatapp is set to zero, either by an
application or, for ENTRY, when the user presses NEXT FORM to request the next form, or
by the FORMSPEC processing language. If the current form is not to be repeated,
VGETNEXTFORM checks
nfname
to determine which form to read from the forms file.
Example
COBOL
CALL "VGETNEXTFORM" USING COMAREA.
BASIC
11 CALL VGETNEXTFORM(C(*))
FORTRAN
CALL VGETNEXTFORM(COMAREA)
SPL/PASCAL
VGETNEXTFORM(COMAREA);
The examples above call VGETNEXTFORM to retrieve the next form from the forms file and
reset the
comarea
according to the values in the next form.