17.10 - Output Session Id - Call-Level Interface Version 2

Teradata® Call-Level Interface Version 2 Reference for Workstation-Attached Systems

Product
Call-Level Interface Version 2
Release Number
17.10
Release Date
October 2021
Content Type
Programming Reference
Publication ID
B035-2418-061K
Language
English (United States)

Usage Notes

The Output Session Id field is CLI’s logical identifier of a given session on the database computer.

Language Variable Name
COBOL: DBCAREA-O-SESS-ID
C: DBCAREA.H: o_sess_id
Routine Action Taken
DBCHINI: writes
DBCHCL: writes (CON)
Used by Action Taken
application program reads

After the application program regains control from a call to DBCHCL for the Connect function, the logical session id is available in the DBCAREA in Output Session Id. Before using the DBCAREA again to call DBCHCL for the session, the application program must copy the value to Input Session Id.

DBCHCL places Output Session Id in the DBCAREA as soon as DBCHCL is called for a session-generating function. Thus Output Session Id is available after the application program regains control from DBCHCL, even in a connect operation.

Compare with Output DBC Session Id. Note that both the database computer and CLI have a number for each session and that the two numbers are not identical.