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

Chapter 6 241
USING VPLUS INTRINSICS
COMMUNICATION AREA
head form, the current form is retrieved. There is a
maximum of eight forms; after eight, each additional form
replaces the most recent form.
$HEAD Retrieve first form displayed when the forms file is
executed (the "head" form).
$END For ENTRY only, terminate execution of VGETNEXTFORM;
return to calling program without resetting any
comarea
items.
repeatapp Two-byte integer that indicates whether the current form is a repeating
form and, if so, whether it is to be appended to itself:
• 0 = Normal sequence, neither repeat nor append
• 1 = Repeat current form
• 2 = Repeat current form, appending it to itself
freezapp Two-byte integer that indicates whether the screen is to be cleared when
the next form is displayed, or whether next form is to be appended to
current form, and, if appended, whether current form is to be frozen on the
screen. If the current form is frozen, it remains on the screen and the next
form is rolled off when the screen is full; otherwise, the current form is
rolled off the screen when the screen is full. The
freezeapp is specified as:
• 0 = Clear screen, neither freeze nor append current form
• 1 = Append next form to current form
• 2 = Freeze current form and append next form to it
cfnumlines Two-byte integer that specifies the number of lines in the current form.
The
cfnumlines is used by VPRINTFORM to print the form off-line.
dbuflen Two-byte integer that specifies the number of bytes in the data buffer for
the current form. Set by VGETNEXTFORM, this length is the sum of all the
concatenated data fields in the form, including any display-only fields.
lookahead Two-byte integer that indicates whether or not look-ahead form loading is
to occur when VREADFIELDS is called.
0 - ON The next form, as defined in FORMSPEC, is loaded before
the current form is read if point-to-point data
communications is being used. If multipoint data
communications is being used, the next form is loaded
after the current form is read. The least recently used
form in the terminal's local form storage memory could be
purged to make room for the new form if there is no room
in the terminal or there are no available entries in the
form storage directory.
1 - OFF No look-ahead form loading is performed, and no forms in
the terminal's local form storage memory are purged
(however, forms could still be purged if VSHOWFORM is called
to preload forms; see the discussion of VSHOWFORM later in