Mechanism‑name
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.