Error handling and trouble shooting

This chapter describes the way of handling certain error situations. Errors may happen while running an application without terminating the program. Usually an error e.g. reading an instance is considered similar to the case, that no instance exists. In case of detected errors, however, an error variable is set and can be checked with databaseError().

Errors are recorded in an error log, which is located in a folder as being defined in the TRACE option. For handling errors properly, one must distinguish between database consistency errors, programming errors and application errors.

Usually, an odaba::Exception will be thrown as soon as a database error has been detected. The exception object passed to the application contains detailed error information including an error description.

Most errors result from improper programming and need not to be considered as serious. Some errors, however, are an indication for serious database problems and should be handled.