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

270 Chapter6
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
VFIELDEDITS
Edits data entered in each field of form and, if indicated, modifies data in the data buffer. If
necessary, sets error flags.
Syntax
VFIELDEDITS { comarea }
Parameters
comarea Must be comarea name specified when forms file was opened with
VOPENFORMF. If not set already, the following
comarea items must be set
before calling VFIELDEDITS:
cstatus Set to zero.
comarealen Set to total number of two-byte words in comarea .
VFIELDEDITS may set the following
comarea items:
numerrs Set to total number of fields in which errors were detected.
cstatus Set to nonzero value if call unsuccessful.
nfname Set to new next form name if name changed by processing
specifications.
repeatapp Set to new current form code if code changed by processing
specifications.
freezapp Set to new next form code if code changed by processing
specifications.
Discussion
This intrinsic checks the data content of each field. It checks that the data type and field
type are correct, and if any special processing specifications were defined for this field in
the Field Edit phase, it checks that the data conforms to these specifications. If any data
formatting or data movement was specified for a field, VFIELDEDITS performs these
functions on the data in the data buffer.
For each field that does not pass the edit checks, VFIELDEDITS sets an error flag. These
error flags are used by the VPLUS intrinsics, as shown in Table 6-9. In addition, these
error flags can be accessed by an application with a call to VGETFORMINFO, which retrieves
a table corresponding to the current error flag settings.