HP Data Entry and Forms Management System (VPLUS) Reference Manual (32209-90024)
Appendix L 651
A Programmer’s Guide to VPLUS
VPLUS Intrinsic Calls
the formsfile.
REPEATAP is the repeat append option and will take on a numeric value from 0 - 2.
These values are defined as follows:
0 Do not repeat the current form 1
1 Current form is to be repeated
2 Current form is to be repeated and appended
FREEZAPP is the freeze append option. This will also take on a numeric value from
0-2. The values for FREEZAPP follow:
0 Clear the current form before displaying the next form
1 Next form is to be appended to the current form
2 Current form is to be frozen before the next form is
appended
VGETNEXTFORM retrieves the next form based on the value of two words in the COMAREA:
REPEATAPP and NFNAME. If the repeat append word indicates the current
form is to be repeated (REPEATAPP=1) or the current form is to be repeated
and appended to itself (REPEATAPP=2), VGETNEXTFORM does not get the next
form. REPEATAPP must be set to 0 before VGETNEXTFORM will retrieve the
next form. The next form is determined by NFNAME. If NFNAME is blank, it
gets the $HEAD form.
Other options for NFNAME, other than an actual form name are:
$END
$HEAD
$REFRESH
$RETURN
Upon the completion of the call to VGETNEXTFORM with $END as the NFNAME, the CFNAME
becomes $END. The application must check the CFNAME to determine to shut down the
application.
With $HEAD, the head form which is specified in FORMSPEC, is retrieved. Within FORMSPEC,
a specific form may be designated as the head form. If this field is left blank, the head form
becomes the first form in the formsfile (alphabetic order of forms).
When VGETNEXTFORM is called with $REFRESH, the terminal is reinitialized. If there are
forms in local forms storage, the forms are cleared. Only the current form is displayed with
$REFRESH, therefore prior appended screens are lost. Data, screen design, windows and
softkeys are displayed again. An alternative to using $REFRESH which takes less overhead
is to simply display the data again. In many cases, where the data is overlaid but the
screen design is intact, this method is sufficient. An example of when this type of refresh
can be used is when another user has sent a WARN message through the user’s form. This
refresh method would simply force data and field enhancements to be rewritten to the
screen.
An example of the alternate method is:
VINITFORM (COMAREA)
SHOWCONTROL (14:1)=1