17.10 - Using Data Length Array - Call-Level Interface Version 2

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

Call-Level Interface Version 2
Release Number
October 2021
Last Update
Content Type
Programming Reference
Publication ID
English (United States)
Last Update

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