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:
- using_data_count and using_data_ptr are both non-zero
- using_data_count is non-zero but using_data_ptr_array is zero
- 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.