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.