Total-length - Teradata Tools and Utilities

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

Product
Teradata Tools and Utilities
Release Number
17.00
Published
June 2020
Language
English (United States)
Last Update
2020-06-18
dita:mapPath
lvt1544831946862.ditamap
dita:ditavalPath
obe1474387269547.ditaval
dita:id
B035-2417
lifecycle
previous
Product Category
Teradata Tools and Utilities

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.