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

Chapter 6 355
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
VSHOWFORM
Displays on the terminal screen the current form from local form storage or from the form
definition buffer, any data in the data buffer, and any messages from the window buffer.
Displays any labels from the key label buffer.
Syntax
VSHOWFORM { comarea }
Parameters
comarea Must be the comarea name specified when the terminal file was opened
with VOPENTERM. If not already set, the following
comarea items must be
set before calling VSHOWFORM:
cstatus Set to zero
comarealen Set to total number of two-byte words in comarea .
windowenh Set to window enhancement code; may be set before call to
code for nondefault enhancement; otherwise, set by
VOPENFORMF to default enhancementspecified in forms file.
If set to zero, window is not enhanced. (Refer to
windowenh
discussion under "Communication Area" earlier in this
section.)
The following
comarea item can be set:
showcontrol Set to change VSHOWFORM control options. The particular
settings are described below.
VSHOWFORM may set the following
comarea values:
cstatus Set to nonzero value if call unsuccessful.
filerrnum Set to file error code if MPE file error.
(Note that
showcontrol is not cleared by VSHOWFORM.)
Discussion
VSHOWFORM displays, on an open terminal screen, the form currently stored as a form image
in the terminal's local form storage or in the form definition area of memory. Any
enhancements specified for the form are used for the display. Data currently in the data
buffer in memory is moved to the appropriate fields of the displayed form. Any message in
the window buffer of memory is displayed in the line of the form selected as the status line.
Also, any current form or global function key labels in the key label buffer are displayed.
Performance Optimization
In order to optimize VSHOWFORM performance, only changed information is written to the
terminal. Thus, if the window has not been changed by VPUTWINDOW or VSETERROR since
the last execution of VSHOWFORM, or if the current form is being repeated in place, these
areas are not rewritten. Also, when a form is repeating in place, only the changed values in
the data buffer area of memory are written by VSHOWFORM. This will be sufficient for most
applications; however, these three optimizations (form, data, window) can be overridden by