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

3- 29
1 = field
itemident A four-byte integer
that identifies a
termination item. If
you have defined
itemtype as a key,
the ENTER key is 0,
function key 1 is 1,
and so on.
If you have defined
itemtype as field, a
positive number
indicates a field
number and a negative
number indicates
screen order.
readopt A four-byte integer
that tells HPDREAD
which read option you
want to use. You can
use the following
values:
-1 = no read
This option returns
an exception to the
application, and is
the implicit entry of
all items (keys and
fields) that are not
defined in the table
identified by
itementry .
0 = interrupt only
1 = unedited read
2 = read and edit -
report errors OR
return data
3 = read and edit -
report errors AND
return data
Note: If you specify
option 3 and data
editing errors occur,
you will get an error
when type conversions
are performed. Use
option 3 when you are
not doing type
conversions.
cursorposition A four-byte integer or 36-byte character array
that is reserved for a feature not yet
implemented. Set this parameter to zero or
spaces.
datadescrpt A compound parameter that tells HPDREAD how
data is to be mapped when it is moved between
data fields on the form and your application.
There are six ways to map data. The first and
simplest way is shown below.
-1 = do not transfer data
0 = moves concatenated string of data to
databuf .
The number of bytes moved is equal to the sum