Session-desc-length is a four-byte field: when the Variable-length-request option is set to 'N', it contains the number of bytes addressed by the Session-desc-pointer field; when the Variable-length-request option is set to 'Y', Session-desc-length is ignored.
Use of Session-desc requires a Connect-type setting of 'C'.
Session-desc-length 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, Session-desc-length is ignored.
In this language... | The variable name for Session-desc-length... |
---|---|
COBOL | SESS-DESC-LEN |
PL/I | SESS_DESC_LEN |
C, C++ | sessDescLen |
IBM Assembler | DBCNISDL |
This routine... | Does this for Session-desc-length... |
---|---|
DBCHINI | writes |
DBCHCL | reads (RCON) |
Session-desc-length is used by... | To... |
---|---|
applications | write |
The value must be positive. The sum of this length and the length used for Workload-pointer must be less than or equal to one of the following values:
The maximum value is approximately. . . | If Maximum-parcel is set to... |
---|---|
32,725 | O |
64,493 | H |
2,147,483,602 | H, and the database supports ExtendedResponse, as indicated by the DBCHQE Extended-response-support query. |
The actual maximum may vary slightly with the version of the database being used; the value may be obtained using the DBCHQE CLIv2-limits query.