If additional data is required by the specified Mechanism-name, Mechanism-data-ptr addresses that data, specified in the character set specified by Mechanism-data-encoding. If Variable-length-request is set to 'N', the data itself is addressed and its length is specified by Mechanism-data-len. If Variable-length-request is set to 'Y', the data follows a two-byte field that contains the length of the data (Mechanism-data-len is ignored). If a Mechanism-name is not specified, the value will be ignored.
Mechanism-data-ptr 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-data-ptr is ignored.
Logon mechanisms are currently not supported for a mainframe-connected system.
| In this language... | The variable name for Mechanism-data-ptr is... |
|---|---|
| COBOL | MECHANISM-DATA-PTR |
| PL/I | MECHANISM_DATA_PTR |
| C, C++ | mechanismDataPtr |
| IBM Assembler | DBCNIMDP |
| This routine... | Does this for Mechanism-data-ptr... |
|---|---|
| DBCHINI | writes |
| DBCHCL | reads (CON) |
| Mechanism-data-ptr is used by... | To... |
|---|---|
| applications | write |