Request-token - Call-Level Interface Version 2

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

Product
Call-Level Interface Version 2
Release Number
15.00
Language
English (United States)
Last Update
2018-09-28
dita:id
B035-2417
lifecycle
previous
Product Category
Teradata Tools and Utilities

Request‑token

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.