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

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.

Note: 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

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.