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.00
Published
June 2020
Language
English (United States)
Last Update
2021-04-19
dita:mapPath
xen1544831946512.ditamap
dita:ditavalPath
obe1474387269547.ditaval
dita:id
B035-2418
lifecycle
previous
Product Category
Teradata Tools and Utilities

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.