16.20 - Request-token - Teradata Tools and Utilities

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

prodname
Teradata Tools and Utilities
vrm_release
16.20
created_date
September 2019
category
Programming Reference
featnum
B035-2417-108K

Request-token is a four byte field that is used to specify a user-defined identifier for the request.

In this language... The variable name for Request-token is...
COBOL DBCAREA-Request-token
PL/I Request-token
C, C++ Request-token
IBM Assembler DBCIURQN
This routine... Does this for Request-token...
DBCHINI writes
DBCHCL reads (CON; RSUP; IWPF; CMD; IRQ)
DBCHWAT uses
Request-token is used by... To...
applications write

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

At the discretion of the application programmer, Request-token may be used in whatever way is useful.

Request-token is primarily used by applications running concurrent requests or sessions, most often to index into or point to some application-maintained request context so that an actual Output-CLIv2-request-number and Input-CLIv2-connection-number can be retrieved for later calls to fetch, rewind, abort, or end a request.