16.20 - Teradata Parcels - 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

Teradata parcels are the basic unit of information for requests and responses. Although CLIv2 allows applications to manipulate request parcels directly (the DBCAREA Request-mode option 'B'), most applications let CLIv2 handle them. For more information, see 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.