15.10 - How Many DBCAREAs to Use - Call-Level Interface Version 2

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

Call-Level Interface Version 2
Programming Reference

The application can use one DBCAREA for all the requests or a separate DBCAREA for each request, or use any combination in between. This choice is available for either multi‑sessions or multi‑requests.


Application Status


facing space limitations

Reuse the one DBCAREA, which involves copying the Output Request Ids, saving them, and replacing them when doing a Fetch, Rewind, or Cancel against that same Teradata SQL request.

If other fields, such as the processing options or buffer addresses or sizes, change from one request to another, they too must be saved and replaced.

Since much less information than the whole DBCAREA is saved, the application can show a significant saving of space at the small cost of unloading and reloading those fields between calls.

able to spare the space for multiple DBCAREAs

Allocate one DBCAREA per concurrent request.

The application can show some saving of time at the cost of the space for the extra DBCAREAs.

Applications may append fields to the DBCAREA for their own use. While allocating storage for, and use of, such fields are the responsibility of the application, associating them with a DBCAREA may be useful to the application, especially if multiple DBCAREAs are used.