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.