16.20 - Mechanism-data-ptr - 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

If additional data is required by the specified Mechanism-name, Mechanism-data-ptr addresses that data, specified in the character set specified by Mechanism-data-encoding. If Varying-length-request is set to 'N', the data itself is addressed and its length is specified by Mechanism-data-len. If Varying-length-request is set to 'Y', the data follows a two-byte field that contains the length of the data (Mechanism-data-len is ignored). If a Mechanism-name is not specified, the value will be ignored.

Mechanism-data-ptr exists only when DBCHINI had been called for a DBCAREA with Total-length set to at least 640 (that is, the returned DBCAREA Level value is at least 1). For a smaller DBCAREA, Mechanism-data-ptr is ignored.

Logon mechanisms are currently not supported for a mainframe-connected system.
In this language... The variable name for Mechanism-data-ptr is...
COBOL MECHANISM-DATA-PTR
PL/I MECHANISM_DATA_PTR
C, C++ mechanismDataPtr
IBM Assembler DBCNIMDP
This routine... Does this for Mechanism-data-ptr...
DBCHINI writes
DBCHCL reads (CON)
Mechanism-data-ptr is used by... To...
applications write