Error Reporter

This section explains how an error reporter is created and how an output error stream can be attached to it. It is divided as follows:

Default Settings and Behavior

Output Error Stream

Default Settings and Behavior

When an IldDbms object is created, an IldErrorReporter object is attached to it. This object is inherited by all IldRequest objects created from that IldDbms object.

The output stream field of the IldErrorReporter object is not set on creation.

Rogue Wave DB Link guarantees that, when an error is raised, the IldErrorReporter object will call one of the following member functions:

IldErrorReporter::dblinkError if the error was raised by the Rogue Wave DB Link API, or

IldErrorReporter::dbmsError if the error was raised by the database server or the RDBMS client API.

Output Error Stream

An output stream (an instance of the C++ class ostream) can be attached to an IldErrorReporter object. Once an output stream has been attached, the error handling mechanism will output the code and text of the error through that stream.

An output stream is attached by a call to the function IldErrorReporter::setOStream and can be retrieved by a call to the function IldErrorReporter::getOStream.

The error code and text are formatted in the output stream like this:

where <function name> indicates the Rogue Wave DB Link member function (from the list in Table 6.2) in which the error was raised:

Error-raising Member Functions in the Class IldDbms
Class IldDbms
Constructor	autoCommitOn	autoCommitOff
commit	connect	disconnect
execute	getAbstractType	getHook
getInfo	getName	getProcedure
getRelation	getSynonym	getTypeInfo
readAbstractTypeNames	readEntityNames	readOwners
readRelationNames	readRelationOwners	readProcedureNames
readSynonymNames	readPrimaryKey	readForeignKeys
readIndexes	readSpecialColumns	rollBack
setCursorMode	setErrorReporter	setTimeOut
startTransaction

Error-raising Member Functions in the Class IldRequest
Class IldRequest
Constructor	Destructor	bindCol
bindParam	closeCursor	execute
fetch	getColADTValue	getColBinaryValue
getColByteValue	getColDateTimeValue	getColIndex
getColIntegerValue	getColLongTextValue	getColMoneyValue
getColName	getColNumericValue	getColRealValue
getColReferenceValue	getLargeObject	getParamBinaryValue
getParamCursorValue	getParamDateTimeValue	getParamIndex
getParamNumericValue	getStatus	insertLongText
insertBinary	isColNull	isNullIndicatorOn
isParamNull	parse	release
removeColLock	removeColArraySize	removeParamArraySize
removeParamLock	setColArraySize	setColPos
setCursorName	setErrorReporter	setParamArraySize
setParamNullInd	setParamValue	setReadOnly

Version 5.8