17.10 - Connect - 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)

Purpose

Establishes a connection between an application and a specific COP server that is used for running Teradata SQL.

Usage Notes

The Connect parcel is sent from the client at the same time that a Logon parcel is sent.

This parcel is generated by CLIv2 on behalf of the application.

The response to a Connect parcel is first a Success parcel and then a RunResponse parcel.

Parcel Data

The following table lists field information for the Connect parcel.

Flavor Field Body Parcel Length Parcel Body Fields
88 24  
  • PartitionName:
  • LogonSequence Number:
  • Function:
  • Pad:
  • 16 bytes
  • 4 bytes
  •  2 bytes
  •  2 bytes

Fields

  • PartitionName is the name of the COP server to which start requests are to be sent.
  • LogonSequenceNumber contains a logon sequence number when Function contains the value 2. At all other times it must contain zero.
  • Function contains one of the following:
Function Number Description
0 Requests that a normal Run be performed.
1 Requests session control allocate a logon sequence number and associate the newly allocated logon sequence number with the requesting session.
2 Requests session control to associate the logon sequence number in logon sequence number with requesting session.
  • Pad is unused.