Error handling in the connector

The connector logs any abnormal condition that it encounters during processing, regardless of the trace level. It writes the error text to the connector log file; the name and location of this file are set by the LogFileName connector configuration property.

The message contains a detailed description of the condition and the outcome and may also include extra information that may aid in debugging, such as business object dumps or stack traces (for exceptions).

For a complete list of error messages, refer to the BIA_ExchangeConnector.txt file installed in the ProductDir\connectors\messages directory.

Table 14 describes some of more common errors and how the connector handles those errors.

Table 14. Connector errors

Error description Error type Error handling
LOGON_FAILED is returned during the HTTP authentication because the UserName and/or UserPassword are invalid or the Server is down. Fatal error The connector detects the error during initialization. It logs a fatal error and then terminates.
The connector detects a connection error when processing a business object service call request. Fatal error The connector logs a fatal error, sends the return code APPRESPONSE_TIMEOUT to trigger email notification, and then terminates.
The connector attempts to retrieve an unsubscribed event. Warning The connector logs the warning and stores the event in the Archive Store with a status of UNSUBSCRIBED.
The connector encounters a problem with the gotApplEvent() method when trying to publish a business object to the integration broker. Error The connector logs the error. The event is stored in the Archive Store with a status of ERROR_POSTING_EVENT.
The Create, Update, or Delete operation for a message fails during service call requests. Error The connector logs the error and returns CWConnectorConstants.FAIL to the calling collaboration or flow.
The Exchange Server error ITEM_NOT_FOUND is returned during event processing because a folder, item, or field does not exist. Error The connector logs the error. The event is stored in the Archive Store with a status of ERROR_OBJECT_NOT_FOUND.
The Exchange Server error E_ACCESSDENIED is returned when the connector attempts to view or update an object on which it does not have permissions. Error The connector logs the error. The event is stored in the Archive Store with a status of ERROR_PROCESSING_EVENT.
The Exchange Server error E_FAIL is returned when an item cannot be updated because the mailbox quota has been exceeded. Error The connector logs the error. The event is stored in the Archive Store with a status of ERROR_PROCESSING_EVENT.

Copyright IBM Corp. 1997, 2004