USING-data-length is a four-byte field that has three meanings, relating to the following:
- Contents of the request string
- Contents of the data string
- Length in bytes of the data string
|In this language...
||The variable name for USING-data-length is...
||Does this for USING-data-length...
||reads (IRQ; IWPF)
|USING-data-length is used by...
|The value of USING-data-length must be positive, with a maximum value of approximately...
||If Maximum-parcel is set to...
The actual maximum may vary slightly with the version of the database being used; the value may be obtained using the DBCHQE CLIv2-limits query
Before calling DBCHCL for the Initiate Request function and if the request contains a USING row descriptor, the application must build a data string.
The data string must contain the data described by the USING row descriptor, and the Variable-length-request will be set to either of the following:
|When Variable-length-request is set to this value...
||the USING-data-length field is ignored and the USING-data-pointer must point to the two-byte area containing the length of the using data string, which is followed by the actual using data string.
||the application must supply the length information in USING-data-length
Since DBCHCL does not parse the request string, the application must check whether the request string contains a USING row descriptor and then to set USING-data-length appropriately.