15.10 - Request-token - Call-Level Interface Version 2

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

prodname
Call-Level Interface Version 2
vrm_release
15.10
category
Programming Reference
featnum
B035-2417-035K

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

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 request id and session id can be retrieved for later calls to fetch, rewind, abort, or end a request.