16.20 - Mechanism-name - 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

Mechanism-name specifies the name (in case-independent EBCDIC, left-justified, padded with spaces) of the logon mechanism to authenticate the connection. A name is ignored if it consists solely of spaces or binary zeroes. If required, additional data for the mechanism can be supplied using the Mechanism-data-ptr and Logon-mechanism-data-length. If the specified mechanism is not supported, the request will be rejected.

Mechanism-name 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-name is ignored.

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

Upon return from the Connect function, Mechanism-name contains the mechanism name used, monocased as necessary.