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

Appendix L 661
A Programmer’s Guide to VPLUS
VPLUS Enhancements
screen order number is a relative number of the field on the form. For example, if there
are five fields on a form and the programmer wants to place the cursor on the fourth
field, the FIELDNUM parameter would contain a “-4”. On the other hand, if
the FIELDNUM parameter is positive, it implies field number creation order. This
number is assigned to the field when the field is created through FORMSPEC. This
number stays with the field unless the form is renumbered through batch mode
FORMSPEC or if the field is deleted from the form
264X Function Key Labels (Introduced on VPLUS B.04.10 in MPE
G.01.01)
With 264X terminals, there are no function key labels like the 262X or 239X terminals. As
of VPLUS version B.04.10 which was introduced in MPE version G.01.01, function key
labels may now be displayed on 264X terminals. With this version of VPLUS, function key
labels appear in lines 23 and 24 of the terminal display on a 264X terminal. With 264X
terminals, function keys may be displayed by performing the following steps:
1. Select “Y” instead of “X” in the 264X box of the TERMINAL/ LANGUAGE SELECTION
MENU.
2. Define the labels using the same methods as with other HP Terminals, for example,
enter the labels using the FORM FUNCTION KEY LABELS MENU, or enter the labels
using the GLOBAL FUNCTION KEY LABELS MENU, or set the labels in your program
calls to VSETKEYLABEL or VSETKEYLABELS.
3. Set the LABELOPTION word in the COMAREA to 1 before a call to VOPENFORMF (as with
all other terminals).
VGETFORMINFO Enhancement (Enhanced on VPLUS B.04.10 in
MPE G.01.01)
Prior to this enhancement, if VFIELDEDITS detected a field in error, the total number of
errors would be set in the NUMERRS word of the user’s COMAREA. All fields would be
highlighted upon a call to VSHOWFORM. No information regarding which fields were found to
be in error is passed to the program.
With VPLUS version B.04.10, VGETFORMINFO has been enhanced to return information on
all fields in error. The information may be used by the program if a special error routine is
to be performed when a certain field is in error. The information buffer returned by
VGETFORMINFO has been expanded to include a 16-word array. This 16-word array is a bit
map of all the fields on the form and can accommodate the maximum of 256 field numbers.
Field numbers may range from 1 to 256, although a form may have a maximum of 128
fields on the form. If the bit corresponding to the field is set to 1, the field is in error.
To decode and set the bits, a new intrinsic called BITMAPCNV is available and documented
in the VPLUS/V Reference Manual, Appendix I.
Batch Mode FORMSPEC (Enhanced on VPLUS B.04.10 in MPE
G.01.01)
There have been several enhancements to batch mode FORMSPEC. Chapter 7 of the