HP 3000 Manuals

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