16.20 - USING-data-length-vector - 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

When USING-data-count is not zero, USING-data-length-vector is a four byte pointer to a vector of four byte lengths. The lengths specify the amount of data addressed by corresponding pointers in the USING-data-pointer-vector when Varying-length-request is not specified. When Varying-length-request is specified, USING-data-length-vector is ignored. The number of entries in the vector is given by USING-data-count.

USING-data-length-vector exists only when DBCHINI had been called for a DBCAREA with Total-length set to at least 640 (that is, the returned DBCAREA Level value is at least 1). For a smaller DBCAREA, USING-data-length-vector is ignored.

In this language... The variable name for USING-data-length-vector is...
COBOL DBRIUDLV
PL/I DBRIUDLV
C, C++ dbriUDLV
IBM Assembler DBRIUDLV
This routine... Does this for USING-data-length-vector...
DBCHINI writes
DBCHCL reads (RSUP; IWPF; IRQ)
USING-data-length-vector is used by... To...
applications write
The value of EACH 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.