17.10 - Token - Call-Level Interface Version 2

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

Product
Call-Level Interface Version 2
Release Number
17.10
Release Date
October 2021
Content Type
Programming Reference
Publication ID
B035-2418-061K
Language
English (United States)

Usage Notes

The Token field is used to specify a user-defined identifier for the request.

Language Variable Name
COBOL: DBCAREA-TOKEN
C: DBCAREA.H: token
Routine Action Taken
DBCHINI: writes
DBCHCL: reads (CON; RSUP; IRQ)
DBCHWAT: uses
Used by Action Taken
application program writes

Token is maintained for each request and is returned by DBCHWAT when a pending request has completed its transfer.

At the application programmer’s discretion, it may be used in whatever way is useful. It is primarily used by application programs running concurrent requests or sessions. It is most often used to index into or point to some application-program-maintained request context, so that an actual request id and session id can be retrieved for later calls to fetch, rewind, abort, or end request.