15.10 - Output CLIv2 Request Id - 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

Output CLIv2 Request Id is a four byte field that is the CLIv2 logical identifier for a given request on the Teradata Database.

 

In this language...

The variable name for Output CLIv2 Request Id is...

COBOL

DBCAREA‑O‑REQ‑ID

PL/I

O_REQ_ID

C

o_req_id

IBM Assembler

DBCOREQN

 

This routine...

Does this for Output CLIv2 Request Id...

DBCHINI

writes

DBCHCL

writes (CON; RSUP; IRQ; IWPF; CMD)

 

Output CLIv2 Request Id is used by...

To...

applications

read

When the application regains control from a call to DBCHCL for any of the following functions, the logical request is available in the DBCAREA in Output CLIv2 Request id.

  • Connect
  • RunStartUp
  • Command
  • Initiate with Protocol‑Function
  • Initiate Request
  • Before using the DBCAREA again to call DBCHCL for an operation related to that request, the application must copy the value to Input CLIv2 Request Id.

    Compare with “TDP Request Number” on page 169.

    Note that CLIv2 and the TDP have a number for each request and that the numbers are not identical.