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 Varying-length-request is set to 'N', the data itself is addressed and its length is specified by Mechanism-data-len. If Varying-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 |