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

254 Chapter6
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
INTRINSIC DESCRIPTIONS
The intrinsics on the following pages are described in alphabetic order for easy reference.
However, this is not the order in which they are normally used. Table 6-7. is provided to
group the intrinsics according to the functions they perform. Note that terminal access is
performed by only seven intrinsics: VOPENTERM, VCLOSETERM, VPLACECURSOR, VSHOWFORM,
VREADFIELDS, VLOADFORMS, and VUNLOADFORM. The remaining intrinsics interact with the
form definition, data buffer, window, and key label areas of memory. An example of the
order in which the intrinsics are used is shown in Table 6-7.
All intrinsics require that three items in
comarea ( cstatus, language and comarealen )
are set before the intrinsic is called. However, two of these items,
language and
comarealen , only need to be initially set, prior to the first intrinsic call, since they are
not modified by any subsequent intrinsics. In contrast,
cstatus should be reset before
calling any intrinsic after an error occurs (except for the intrinsic VERRMSG that uses
cstatus in retrieving the associated error message).
No running examples are provided with the intrinsic descriptions. Instead, Appendix A
contains sample programs that use many of the intrinsics described in this section.
Table 6-7. Intrinsics by Function Group
Function Intrinsic
Access to Terminal VOPENTERM
VCLOSETERM
VSHOWFORM
VPLACECURSOR
VREADFIELDS
VLOADFORMS
VUNLOADFORM
Access to Forms Definition VOPENFORMF
VGETFIELDINFO
VGETFORMINFO
VPRINTFORM
VCLOSEFORMF
VGETFILEINFO
VGETNEXTFORM
VCHANGEFIELD
Data Processing VINITFORM
VFINISHFORM
VFIELDEDIT
Data Entry VCLOSEBATCH
VPOSTBATCH
VWRITEBATCH
VOPENBATCH
VREADBATCH
Programmatic Access to Data VGETBUFFER
VPUTBUFFER
VGETtype
VGETFIELD
VPUTFIELD
VPUTtype
Access to Error/Status Window,
Function Key Labels, Native
Language ID
VERRMSG
VGETKEYLABELS
VSETKEYLABELS
VGETLANG
VSETERROR
VPUTWINDOW
VSETKEYLABEL
VSETLANG