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... |
|---|---|
| COBOL | DBCAREA-USING-DATA-LEN |
| PL/I | USING_DATA_LEN |
| C, C++ | using_data_len |
| IBM Assembler | DBRIUDL |
| This routine... | Does this for USING-data-length... |
|---|---|
| DBCHINI | writes |
| DBCHCL | reads (IRQ; IWPF) |
| USING-data-length is used by... | To... |
|---|---|
| applications | write |
| The value of USING-data-length must be positive, with a maximum value of approximately... | If Maximum-parcel is set to... |
|---|---|
| 32763 | O |
| 65531 | H |
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... | 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, the application must check whether the request string contains a USING row descriptor and then to set USING-data-length appropriately.