Total Length - Call-Level Interface Version 2

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

Product
Call-Level Interface Version 2
Release Number
15.10
Language
English (United States)
Last Update
2018-10-07
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

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.

Note: In the IBM Assembler macro, the symbol DBCAREAL holds the results of the calculation of the length by the assembler.