17.10 - Using Data Length Array - 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

The Using Data Length array field points to an array of using_data_len elements.

using_data_len_array is similar to using_data_len except that instead of containing a single length, it points to an array of lengths. Each length is associated with the corresponding element referenced by using_data_ptr_array. If var_len_req is set to 'Y', using_data_ptr_array must be zero; in this case, CLIv2 will extract the length from the first two bytes of each using_data_ptr_array element (and the length of each element is necessarily limited to 64K - 1).

Language Variable Name
COBOL: DBCAREA-USING-DATA-LEN-ARRAY
C: DBCAREA.H: using_data_len_array
Routine Action Taken
DBCHINI: writes
DBCHCL: reads (IRQ)
Used by Action Taken
application program writes
Error code 502 will be returned under the following circumstances:
  1. using_data_count and using_data_ptr are both non-zero
  2. using_data_count is non-zero but using_data_ptr_array is zero
  3. using_data_ptr_array is non-zero and using_data_len_array is zero but var_len_req is set to 'N'

Error Code 502

CLI502 BADARRAYOPS: Invalid parameter combination for array-operations.