17.10 - Positioning-value - Call-Level Interface Version 2

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

Call-Level Interface Version 2
Release Number
Release Date
October 2021
Content Type
Programming Reference
Publication ID
English (United States)

Usage Notes

Positioning-value specifies either the row number, the byte offset into a BLOB, or the character offset into a CLOB, from which the Fetch is to be performed when Positioning-action indicates other than Next-parcel.

When specifying a row number, by convention, a value of zero represents parcels that precede the first row (such as, Success or OK). When specifying a byte or character offset, by convention, a value of zero corresponds to the first byte or character. A value of zero also returns Success, Data-information-extended, and No-operation parcels before the Multipart-record parcel for the start of the data.

Language Variable Name
C: DBCAREA.H: positioning_value or dbfiPVal
Routine Action Taken
DBCHINI: writes
DBCHCL: reads (FET)
Used by Action Taken
application program writes

Use of this setting does not require use of Change-option. That is, honoring Positioning-value depends only upon the setting of Positioning-action, not Change-option.