16.20 - Run-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

Run-pointer is a four-byte field that specifies a particular set of services to be used by the session.

In this language... The variable name for Run-pointer is...
COBOL DBCAREA-RUN-PTR
PL/I RUN_PTR
C, C++ run_ptr
IBM Assembler DBCNIRSP
This routine... Does this for Run-pointer...
DBCHINI writes
DBCHCL reads (CON)
Run-pointer is used by... To...
applications write

If Run-pointer is zero, DBCHCL uses DBC/SQL as the default value.

The application may specify the value of Run-pointer.

To do so, the program must build a run string or a Connect parcel body, and set Run-pointer one of the following addresses:

  • the run string for the Run parcel
  • the connect parcel body before calling DBCHCL for the Connect function

DBC/SQL is an allowed value. Run string is not case-sensitive.

If Varying-length-request is... Then Run-pointer is the address of the...
N beginning of the run string.
Y two-byte length field that precedes the run string.