15.10 - Session-desc-length - Call-Level Interface Version 2

Teradata Call-Level Interface Version 2 Reference for Mainframe-Attached Systems

prodname
Call-Level Interface Version 2
vrm_release
15.10
category
Programming Reference
featnum
B035-2417-035K

Session‑desc‑length is a four-byte field: when the Variable‑length‑request option is “N” it contains the number of bytes addressed by the Session‑desc‑pointer field; when the Variable‑length‑request option is “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

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 Teradata Database supports ExtendedResponse, as indicated by the DBCHQE Extended‑response‑support query.

The actual maximum may vary slightly with the version of the Teradata Database being used; the value may be obtained using the DBCHQE CLIv2-limits query.