Input-CLIv2-connection-number - Teradata Tools and Utilities

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

Deployment
VantageCloud
VantageCore
Edition
VMware
Enterprise
IntelliFlex
Lake
Product
Teradata Tools and Utilities
Release Number
20.00
Publication Date
October 2023
Content Type
Programming Reference
Publication ID
B035-2417-103K
ft:locale
en-US
ft:lastEdition
2025-11-21
dita:mapPath
apo1695647516691.ditamap
dita:ditavalPath
obe1474387269547.ditaval
ft:sourceId
dita
dita:id
vfj1470443597526
Product Category
Teradata Tools and Utilities

The Input-CLIv2-connection-number is a four-byte field that specifies the session to be acted on by DBCHCL.

In this language... The variable name for Input-CLIv2-connection-number is...
COBOL DBCAREA-I-SESS-ID
PL/I I_SESS_ID
C, C++ i_sess_id
IBM Assembler DBCICONN
This routine... Does this for Input-CLIv2-connection-number...
DBCHINI writes
DBCHCL reads (RSUP; IRQ; FET; REW; ERQ; ABT; DSC; CMD; IWPF; CRQ)
Input-CLIv2-connection-number is used by... To...
applications write

Applications copy the value from Output-CLIv2-connection-number into Input-CLIv2-connection-number. If an application uses the same DBCAREA to run sessions concurrently, it should save Output-CLIv2-connection-number from each session logon.

Applications must store the appropriate value of Output-CLIv2-connection-number in Input-CLIv2-connection-number whenever then need the next DBCHCL call to affect a different session.

When DBCHCL is called for the RunStartUp, Command, Initiate with Protocol-function, or Initiate Request function, an implicit Connect function takes place first if Input-CLIv2-connection-number is zero.