Output Request Id - Call-Level Interface Version 2

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

Product
Call-Level Interface Version 2
Release Number
16.20
Published
September 2019
Language
English (United States)
Last Update
2019-10-12
dita:mapPath
uny1527114222311.ditamap
dita:ditavalPath
Audience_PDF_include.ditaval
dita:id
B035-2418
lifecycle
previous
Product Category
Teradata Tools and Utilities

Usage Notes

The Output Request Id field is CLI’s logical identifier of a given request on the database computer.

Language Variable Name
COBOL: DBCAREA-O-REQ-ID
C: DBCAREA.H: o_req_id
Routine Action Taken
DBCHINI: writes
DBCHCL: writes (CON; RSUP; IRQ)
Used by Action Taken
application program reads

When the application program regains control from a call to DBCHCL for the Connect, Run Startup, or Initiate Request function, the logical request id is available in the DBCAREA in Output Request Id.

Before using the DBCAREA again to call DBCHCL for an operation related to that request, the application program must copy the value to Input Request Id.

DBCHCL places Output Request Id in the DBCAREA as soon as DBCHCL is called for a request-generating function. Output Request Id is available after the application program regains control from DBCHCL, even in a connect operation.

Compare with TDP Request Number, below. The Teradata Database and CLI have a number for each request and the numbers are not identical.