INTRINSIC DESCRIPTIONS [ HP Data Entry and Forms Management System (VPLUS/V) ] MPE/iX 5.0 Documentation
HP Data Entry and Forms Management System (VPLUS/V)
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 Figure 6-2.
Table 6-7. Intrinsics by Function Group
---------------------------------------------------------------------------------------------
| | |
| Function | Intrinsic |
| | |
---------------------------------------------------------------------------------------------
| | |
| Access to Terminal | VOPENTERM VREADFIELDS |
| | VCLOSETERM VLOADFORMS |
| | VSHOWFORM VUNLOADFORM |
| | VPLACECURSOR |
| | |
---------------------------------------------------------------------------------------------
| | |
| Access to Forms Definition | VOPENFORMF VCLOSEFORMF |
| | VGETFIELDINFO VGETFILEINFO |
| | VGETFORMINFO VGETNEXTFORM |
| | VPRINTFORM VCHANGEFIELD |
| | |
---------------------------------------------------------------------------------------------
| | |
| Data Processing | VINITFORM VFIELDEDIT |
| | VFINISHFORM |
| | |
---------------------------------------------------------------------------------------------
| | |
| Data Entry | VCLOSEBATCH VOPENBATCH |
| | VPOSTBATCH VREADBATCH |
| | VWRITEBATCH |
| | |
---------------------------------------------------------------------------------------------
| | |
| Programmatic Access to Data | VGETBUFFER VGETFIELD |
| | VPUTBUFFER VPUTFIELD |
| | VGETtype VPUTtype |
| | |
---------------------------------------------------------------------------------------------
| | |
| Access to Error/Status Window, | VERRMSG VSETERROR |
| Function Key Labels, Native | VGETKEYLABELS VPUTWINDOW |
| Language ID | VSETKEYLABELS VSETKEYLABEL |
| | VGETLANG VSETLANG |
| | |
---------------------------------------------------------------------------------------------
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.
Figure 6-2. Intrinsic Flow
Figure 6-2. Intrinsic Flow (continued)
Dependency Between Intrinsics
Certain intrinsics must be called before other intrinsics can be
executed. Figure 6-3 illustrates the standard dependencies among
intrinsics. For example, the terminal file must be opened before any
other intrinsics are called if prompts are to be sent to the terminal.
Each of the three files, terminal, forms, and batch must be opened before
operations can be performed on these files and before the files can be
closed.
Figure 6-3. Intrinsic Dependencies
MPE/iX 5.0 Documentation