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

Chapter 6 273
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
VGETARBINFO
A new VPLUS intrinsic has been added to retrieve the VPLUS ARB field mapping
information. The intrinsic is named VGETARBINFO and is callable as follows:
CALL “VGETARBINFO” USING VPLUS-COMAREA,
ARB-INFO-BUF,
INFO-BUF-LEN.
Record VPPLUS-COMAREA << use existing definitions >>
Record ARB-INFO-BUF:
Record ARB-INFO-HEADER:
2 byte integer NUM-OF-ENTRIES; << input only >>
2 byte integer ENTRY-LEN; << input only >>
6 byte array FORM-NAME; << input only >>
16 byte array FILLER; << reserved for future use >>
2 byte integer NUM-ARB-FLDS. << output only >>
Table of record ARB-INFO-DETAIL:
2 byte integer FIELD-NUM; << input only >>
10 byte array ARB-DATA-TYPE; << output only >>
2 byte integer ARB-DATA-LEN; << output only >>
2 byte integer ARB-BUF-OFFSET. << output only >>
2 byte integer INFO-BUF-LEN. << total 2 byte word length of >>
<< ARB-INFO-BUF, minimum valid >>
<< length is 27. >>;
NUM-OF-ENTRIES indicates number of ARB-INFO-DETAIL table entries and
must be zero or greater; if number of entries is zero then
the intrinsic returns immediately to the application (in
other words, does a no-op).
ENTRY-LEN indicates number of ARB-INFO-DETAIL table entries and
must be zero or greater; if number of entries is zero then
the intrinsic returns immediately to the application (in
other words, does a no-op).
FORM-NAME contains justified, upshifted form name of 1 to 15
characters, blank terminated.
FILLER reserved for future use; should be initialized to 16 blanks.
NUM-ARB-FLDS at output indicates the number of ARB fields defined for the
specified form. Values for NUM-ARB-FLDS range from zero
(no active ARB fields in specified form ARB; all are filler), to
128 (maximum number of fields in any one form).
NOTE If this intrinsic is called for a form with zero active fields in the form’s ARB,
the intrinsic continues to process all ARB-INFO-DETAIL entries, returning
$NOTARBFLD for each entry.)
FIELD-NUM is ARB-INFO-DETAIL table key and contains field number