15.10 - Total Length - Call-Level Interface Version 2

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

prodname
Call-Level Interface Version 2
vrm_release
15.10
category
Programming Reference
featnum
B035-2417-035K

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.