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

Chapter 6 271
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
After setting error flags for all fields with errors, VFIELDEDITS saves the error number of
the first field with an error. (Fields are counted in screen order, starting at the top left and
moving left to right, then top to bottom.) VFIELDEDITS sets
numerrs to the total number of
fields in which errors were found.
If requested by a call to VERRMSG, the text associated with the error number in the VPLUS
error message file, or the associated custom error message, is returned to an application. If
requested by a call to VPUTWINDOW, the message is copied to the window area of memory.
Then, a call to VSHOWFORM can be used to display this message on the terminal screen and
enhance the fields with errors.
Example
COBOL
CALL "VFIELDEDITS" USING COMAREA.
BASIC
150 CALL VFIELDEDITS(C(*))
FORTRAN
CALL VFIELDEDITS(COMAREA)
SPL/PASCAL
VFIELDEDITS(COMAREA);
Table 6-9. Actions Used by Intrinsics
Intrinsic Action
VGETNEXTFORM Initializes all the error flags to zero.
VFIELDEDITS
VFINISHFORM
VINITFORM
VSETERROR
Each may set field error flags on, increment numerrs , and set an internal
error number used by VERRMSG.
VSHOWFORM Enhances the fields whose error flags are set.
VREADFIELDS Resets the flags to zero after the form is displayed.
VPUTBUFFER
VPUTFIELD
VPUTtype
Each may clear field error flags and decrement numerrs if new data is
entered into a field with an error.