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.