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

Chapter 6 287
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
Passing INFOBUF Without Entering Keys
Keys are optional. If you do not supply a key to indicate the first form you want
information about, VGETFORMINFO starts with the first form not already reported on by the
current call.
As an example, suppose you want information about 3 forms, and you enter form number 6
as a key. VGETFORMINFO returns information about forms 6, 7, and 8. If you enter no keys,
VGETFORMINFO returns information about forms 1 through 3.
Table Wraparound
VGETFORMINFO starts over with the first form in the file if you request information about
more forms than are in the file or, if when you pass a key, your request goes beyond the end
of the file.
Suppose a file has 10 forms. If you request information about 5 of the forms and enter form
number 8 as a key, VGETFORMINFO returns information about forms 8 through 10, and then
goes to the beginning of the file and returns information about forms 1 and 2.
Table 6-12. Form Information Buffer
Data Type Position Contents Comments
Integer
(Two-byte)
1 numofentries Required
2 entrylength Required
Character
Array
(16-byte)
3-10 Form name Permissible key; last byte of position 10 is
unused (15 bytes maximum).
Integer
(Two-byte)
11 Form number Permissible key; forms are ordered within the
forms file in alphabetic order, thus this
argument reflects the order of the form within
the file, not a permanently assigned form
numeric identifier. As a result, the number may
change if the forms file is recompiled.
12 Number of fields
in form
13 Databufferlength
in bytes
Character
Array
(16-byte)
14-21 Name of next
form.
Last byte of position 21 is unused.
Character
(Two-byte)
22 Repeat option. First byte of position 22; may be N, A, or R.
22 Next form option Last byte of position 22; may be C, A, or F.
Integer
Array
(32-byte)
23-38 Fields in error. Bit map; bit is on if field is in error.