Failure - Teradata Tools and Utilities

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

Product
Teradata Tools and Utilities
Release Number
17.10
Published
June 2021
Language
English (United States)
Last Update
2021-07-01
dita:mapPath
zwv1608578409227.ditamap
dita:ditavalPath
obe1474387269547.ditaval
dita:id
B035-2417
Product Category
Teradata Tools and Utilities

Purpose

Indicates that the response to a request was not successfully processed by the database.

Usage Notes

In contrast to the Error or StatementError parcel, the Failure parcel indicates that the Teradata SQL response has been discarded and the Teradata SQL request and transaction in which it was embedded, if any, have been aborted and backed out of the database.

When ANSI Transaction-semantics are in effect, a Failure response parcel rolls back only the request causing the error unless that error threatens the integrity of the database, in which case the entire transaction is rolled back.

This parcel is generated by the database.

Parcel Data

The following table lists field information for Failure.

Flavor Mnemonic TRDSPBEF
Field Length Value
9 TRDSPFFL PBEFSNUM 2-byte unsigned integer The number of the Teradata SQL statement in the Teradata SQL request in which the problem occurred.
PBEFINF 2-byte unsigned integer Any value which is associated with the error code, described in Teradata Vantage™ - Database Messages, B035-1096 for the message number that is the same as the error code.
PBEFCOD 2 byte unsigned integer The database error code, described in Teradata Vantage™ - Database Messages, B035-1096 for the message number that is the same as the error code.
PBEFMTL 2 byte unsigned integer The number of bytes in the message in the PBEFMTX field; zero if no message text is available.
    PBEFMTX Characters in the session character set when the request was initiated. Any message text.