16.20 - Total-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

Total-length is a four byte field that specifies the length of the DBCAREA in bytes.

In this language... The variable name for Total-length is...
COBOL DBCAREA-TOTAL-LEN
PL/I TOTAL_LEN
C, C++ total_len
IBM Assembler DBCSIZE
This routine... Does this for Total-length...
DBCHINI reads
DBCHCL reads
Total-length is used by... To...
applications write

Total-length must be initialized by the application before calling DBCHINI.

The current length of the DBCAREA is 1024 bytes (Level 2), but it is preferable to use a symbolic value rather than a constant. The length of the DBCAREA may be increased in the future. For lengths greater than 384 but less than 640, greater than 640 but less than 1024, or greater than 1024, the excess is assumed to be an application appendage to the DBCAREA.

These Assembler mnemonics can be used:

Mnemonic Value Meaning
DBCAOLEN 384 DBCAREA original length
DBCA1LEN 640 DBCAREA expansion Level 1 + DBCAOLEN
DBCA2LEN 1024 DBCAREA expansion Level 2 + DBCA1LEN
DBCAREAL 1024 Size of the current DBCAREA maximum.
In the IBM Assembler macro, the symbol DBCAREAL holds the results of the calculation of the length by the assembler.