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...|
|This routine...||Does this for USING-data-length...|
|DBCHCL||reads (IRQ; IWPF)|
|USING-data-length is used by...||To...|
|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 Teradata 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 Varying-length-request will be set to either of the following:
|When Varying-length-request is set to this value...||Then...|
|Y||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.|
|N||the application must supply the length information in USING-data-length|
Since DBCHCL does not parse the request string, it is the application‘s responsibility to check whether the request string contains a USING row descriptor and then to set USING-data-length appropriately.