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

232 Chapter6
USING VPLUS INTRINSICS
HOW INTRINSICS ARE USED
As is done in ENTRY, during data collection, data in the data buffer can be written to the
batch file by VWRITEBATCH. The data in the batch file can be read from the batch file to the
data buffer by VREADBATCH. Typically, data is read from the batch file for display at the
terminal during browse and modify operations.
Window Area
If the field editing specifications detect an error in data entry or data movement, an error
flag is set for the field. When called, VERRMSG returns the message associated with the
error, and VPUTWINDOW puts the message into the window. If an error is detected by an
application, VSETERROR may be used to set the error flag, and also to put any message
associated with the error into the window. Any non-error messages generated by an
application are put in the window by VPUTWINDOW. A subsequent call to VSHOWFORM
displays the contents of the window at the terminal.
Key Label Area
If there are user-defined function key labels, these labels are transferred to the key label
area of memory. There is a key label area for global function key labels and another area
for current form labels (global labels are associated with a forms file; form labels are
associated only with the current form).
Labels may be defined with FORMSPEC. Alternately, VSETKEYLABEL or VSETKEYLABELS
may be used to override existing labels with labels from the application. Global labels
defined with FORMSPEC are transferred to the global key label area when the forms file
is opened by VOPENFORMF. Form labels defined by FORMSPEC are transferred to the form
key label area by VGETNEXTFORM. A global or current form label specified by VSETKEYLABEL
is copied into the appropriate key label area from an application. VSETKEYLABELS functions
in the same manner for multiple label definitions. Labels are displayed on HP terminals by
a call to VSHOWFORM.