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

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

prodname
Teradata Tools and Utilities
vrm_release
16.20
created_date
September 2019
category
Programming Reference
featnum
B035-2417-108K

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.