17.10 - using-data-count - Call-Level Interface Version 2

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

Product
Call-Level Interface Version 2
Release Number
17.10
Release Date
October 2021
Content Type
Programming Reference
Publication ID
B035-2418-061K
Language
English (United States)

Usage Notes

using-data-count is a four byte field that indicates that using-data-ptr-array addresses a list of pointers to areas containing data that is referred to by the USING clause in the request string. The number of pointers in the list is the value of using-data-count.

Similarly, if Variable-length-request is not specified, using-data-length-vector either contains the length of the using-data or addresses a list of four byte values containing the length of each area of using-data. If Variable-length-request is specified, using-data-length-vector is unused.

using-data-pointer (along with the associated length) is functionally equivalent to using-data-count of one (along with the associated data and lengths).

A using-data-count of one (along with the associated data and lengths) is functionally equivalent to the existing using-data-pointer (along with the associated length). A using-data-count greater than one will be rejected if the server does not support Array Operations. The DBCHQE Array-operations may be used to ascertain whether the server supports this feature.

Language Variable Name
COBOL: DBCAREA-USING-DATA-COUNT
C: DBCAREA.H: using_data_count
Routine Action Taken
DBCHINI writes
DBCHCL reads (RSUP; IWPF; IRQ)
Used by Action Taken
application program writes