16.20 - USING-data-length - Teradata Tools and Utilities

Teradata® Call-Level Interface Version 2 Reference for Mainframe-Attached Systems

prodname
Teradata Tools and Utilities
vrm_release
16.20
created_date
September 2019
category
Programming Reference
featnum
B035-2417-108K

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 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

See Varying-length-request.

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.