Connect - Call-Level Interface Version 2

Connect

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.