SQLException Class

The SQLException class provides information on generated errors, their codes and associated messages.

SQLException()

This is the SQLException constructor.

SQLException();

SQLException(
   const SQLException &e);

e

getErrorCode()

Gets the database error code.

Syntax

int getErrorCode() const;

getMessage()

Returns the error message string of this SQLException if it was created with an error message string. Returns NULL if the SQLException was created with no error message.

Syntax

string getMessage() const;

getNLSMessage()

Returns the error message string of this SQLException if it was created with an error message string. Passes the globalization enabled environment. Returns a NULL string if the SQLException was created with no error message. The error message is in the character set associated with the environment.

Syntax

string getNLSMessage(
   Environment *env) const;

env

getNLSUStringMessage()

Returns the error message UString of this SQLException if it was created with an error message UString. Passes the globalization enabled environment. Returns a NULL UString if the SQLException was created with no error message. The error message is in the character set associated with the environment.

Syntax

UString getNLSUStringMessage(
   Environment *env) const;

env

getUStringMessage()

Returns the error message UString of this SQLException if it was created with an error message UString. Returns a NULL UString if the SQLException was created with no error message. The error message is in the character set associated with the environment.

Syntax

UString getUStringMessage() const;

getXAErrorCode()

Determine if the thrown exception is due to an XA or an SQL error.

Used by C++ XA applications with dynamic registration. Returns an XA error code if the exception is due to XA, or XA_OK otherwise.

Syntax

int getXAErrorCode(
   const string &dbname) const;

dbname

setErrorCtx()

Sets the pointer to the error context.

Syntax

void setErrorCtx(
   void *ctx);

ctx

what()

Standard C++ compliant function; returns the error message associated with the SQLException.

Syntax

const char *what() const throw();