16.20 - Request-pointer - 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-pointer is a four byte field that specifies the address of the request string.

In this language... The variable name for Request-pointer is...
COBOL DBCAREA-REQ-PTR
PL/I REQ_PTR
C, C++ req_ptr
IBM Assembler DBRIRQP
This routine... Does this for Request-pointer...
DBCHINI writes
DBCHCL reads (IRQ; IWPF; CMD; CRQ)
Request-pointer is used by... To...
applications write

Before calling DBCHCL for the Initiate Request function, the application must build a request string, such as a Teradata SQL request.

If Varying-length-request is set to... Then Request-pointer must contain the address of...
N the beginning of the request string.
Y the two-byte length field immediately preceding the request string (see Varying-length-request).

The request string should not be enclosed in apostrophes.

If there is more than one statement in the request, a semicolon must separate the statements. A semicolon after the last statement in the request is optional.