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

176 Chapter4
Advanced Forms Design
PHASES
PHASES
Used to determine when specified processing specifications are executed.
Syntax
phaseheader
[ statement ]
.
.
.
[ statement ]
Parameters
phaseheader One of the following headings. The phase headings must be specified in the
order shown:
CONFIG Perform the following configuration during form
presentation.
INIT Perform the following statements during initialization
(VINITFORM).
FIELD Perform the following statements during the field edit
phase (VFIELDEDITS).
FINISH Perform the following statements during the finish phase
(VFINISHFORM).
Configuration processing specifications must always be preceded by the
phase header CONFIG. The INIT header can be omitted if the initialization
processing specifications are followed by the FIELD phase header and field
edit processing specifications. The FIELD phase header can be omitted if
there are no configuration or initialization processing specifications. The
FINISH header must always be specified to indicate that a statement is to
be executed in that phase.
statement A processing statement to be executed in the specified phase.
Discussion
During the configuration phase, local edits are loaded to terminals that support the local
edit feature (see Appendix G), and the output device and error lights to be lit are identified
for data capture devices. During the initialization phase, all fields in the form are
initialized; during the field edit phase, all fields (in screen order left to right, top to bottom)
are validated and edited. An application usually requests execution of the finish phase
only when all fields have passed the edit tests of the field phase. Finish statements apply
to the entire form. (Refer to Figure 4-1.for an illustration of the flow of form execution
under ENTRY control.)
You can specify that a statement be executed during a particular phase with the phase