High-Level Screen Management Intrinsic Library Reference Manual (32424-90002)

3- 27
HPDREAD
Reads, edits, and transforms data, and returns the information to the
application.
Syntax
HPDREAD globalpak, returnpak, readpak, readitems, cursorposition,
datadescrpt, databuf, fieldlist
Parameter Descriptions
globalpak A compound parameter that passes information
between intrinsics. For a complete description
of this parameter, see "Global Parameters" in
Chapter 3.
returnpak A compound parameter that passes information
back from the intrinsic to the application.
For a complete description of this parameter,
see "Global Parameters" in Chapter 3.
readpak A compound parameter that modifies the default
operations of HPDREAD. It is made up of the
following subparameters:
readtime A four-byte integer
that tells HPDREAD
how many seconds to
allow for a read.
The values you can
use are:
0 = do not time the
read
>0 = time the read
and report an
exception if a
timeout occurs
enablereformat A four-byte integer
used by the
application to tell
HPDREAD to reformat
the data after it is
collected and edited,
and before it is
returned to your
application. Data is
reformatted according
to the specifications
embedded in the form.
Reformatting does not
include data type
conversions. You can
use the following
values:
0 = ignore, do not
reformat data
1 = reformat data
doreread A four-byte integer
that is used by the
application to
indicate that this
read is a consecutive
or follow-up read.
You can supply the