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

4- 2
subparameters. The first four subparameters supply header information;
the last six provide table information.
You supply values for some or all of these subparameters, depending on
the mapping method you are using. In some cases, a subparameter is not
used by a particular method, but it must be passed. The particular
values that you can supply for a particular mapping method are discussed
under that method.
These are the ten
datadescrpt subparameters:
descrpttype A four-byte integer that tells Hi-Li the data
mapping method you want to use.
buflen A four-byte integer that indicates the number
of bytes of buffer data you want to move.
rtnbuflen A four-byte integer that indicates the number
of bytes of buffer data actually moved.
entrycnt A four-byte integer that indicates the number
of active field entries in the table.
fldentry Identifies a table you create in your
application.
fldid A four-byte integer or 32-byte character array
which identifies a field.
fldloc A four-byte integer that gives the field
location by indicating the offset of the field
within the buffer.
fldlen A four-byte integer that indicates the number
of bytes of field data you want to move.
rtnfldlen A four-byte integer that indicates the number
of bytes of field data actually moved.
typcnvcode A four-byte integer that tells Hi-Li the type
of data conversion you want performed.
Data Transfer Method A
Data transfer method A is the simplest way of indicating data transfer.
You can transfer all data or no data. You indicate a transfer of all
data by providing the value 0 for
datadescrpttype or a transfer of no
data with a value of -1. When all data is moved, it is moved as a
concatenated string to or from the
databuf parameter. The number of
bytes moved is equal to the sum of the lengths of all the fields on the
form. No data type conversion takes place; all data is transferred as
type CHAR.
To indicate this method of transfer, you must supply the
descrpttype
subparameter and one of the following values:
-1 = transfer no data
0 = transfer all data