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.