15.10 - Parcels - Call-Level Interface Version 2

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

Call-Level Interface Version 2
Programming Reference

Parcels are the basic unit of information for requests and responses. Although CLIv2 allows applications to manipulate request parcels directly, most applications let CLIv2 handle them. However, applications must process responses parcel by parcel. Each type of parcel is uniquely identified by its flavor. For more information, see Chapter 15: “Parcels for Basic Applications.”

When the request consists of multiple statements, a successful response contains the results for all statements. The parcels for each statement begin with either a Success, OK, or StatementStatus parcel (depending on the Response‑mode or Statement‑status.) and end with an EndStatement parcel. For unsuccessful statements, the Error, StatementError, or Failure parcel contains the statement number.

Three response parcels (ElicitData, ElicitFile, and ElicitDataByName) prompt CLIv2 to provide additional information needed to complete requests. The application continues the request by providing the additional information.