16.20 - Workload-length - Teradata Tools and Utilities

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

prodname
Teradata Tools and Utilities
vrm_release
16.20
created_date
September 2019
category
Programming Reference
featnum
B035-2417-108K

Workload-length is a four-byte field: when the Varying-length-request option is “N” it contains the number of bytes addressed by the Workload-pointer field; when the Varying-length-request option is 'Y', Workload-length is ignored.

Use of Workload requires a Connect-type setting of “C”.

Workload-length exists only when DBCHINI had been called for a DBCAREA with Total-length set to at least 640 (that is, the returned DBCAREA Level value is at least 1). For a smaller DBCAREA, Workload-length is ignored.

In this language... The variable name for Workload-length is...
COBOL WORKLOAD-LEN
PL/I WORKLOAD_LEN
C, C++ workloadLen
IBM Assembler DBCNIWLL
This routine... Does this for Workload-length...
DBCHINI writes
DBCHCL reads (RCON)
Workload-length is used by... To...
applications write

The value must be positive. The sum of this length and the length used for Session-desc-pointer must be less than or equal to one of the following values:

The maximum value is approximately... If Maximum-parcel is set to...
32,725 O
64,493 H
2,147,483,602 H, and Teradata Database supports ExtendedRespond, as indicated by the DBCHQE Extended-response-support query.

The actual maximum may vary slightly with the version of Teradata Database being used; the value may be obtained using the DBCHQE CLIv2-limits query.