15.10 - SQLCODE Variable - Preprocessor2 for Embedded SQL

Teradata Preprocessor2 for Embedded SQL Programmer Guide

prodname
Preprocessor2 for Embedded SQL
vrm_release
15.10
category
Programming Reference
featnum
B035-2446-035K

SQLCODE contains a negative value when an error condition is reported. A positive value indicates that a warning has occurred.

If no exception or error condition is encountered during processing, PP2 sets SQLCODE to zero.

SQLCODE is defined as a long integer variable:

DCL SQLCODE FIXED BIN(31);

Some exception conditions are not reflected in SQLCODE. Data truncation on assignment of a value to a host variable is returned in SQLCODE(+902). In these cases, the SQLWARN fields or any indicator variables associated with a host variable are set to indicate these conditions.

The application must always check the SQLCODE variable upon return from processing an executable statement. Use the WHENEVER statement as one method to accomplish SQLCODE checking.

A SQLCODE and a SQLSTATE variable can be defined for the same compilation unit. Both contain valid result codes.

For details on the ANSI SQLCODE variable, see SQL Stored Procedures and Embedded SQL (B035‑1148).