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
16.10
Published
May 2017
Language
English (United States)
Last Update
2018-05-01
dita:mapPath
ggf1488824663364.ditamap
dita:ditavalPath
Audience_PDF_include.ditaval
dita:id
B035-2418
lifecycle
previous
Product Category
Teradata Tools and Utilities

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