In general, whenever the adapter encounters an error, it logs an error message through the connector API.
All error messages are stored in an external message file, as described in Using log and trace files.
For all operations, if a connection cannot be established to eMatrix or if the connection is lost during processing, the adapter returns the code APPRESPONSETIMEOUT and logs a fatal error. This causes the connector to be terminated and an e-mail notification is sent to the administrator.
The adapter takes action to recover from unresolved or incomplete events depending on the value of the configuration property s.
The options are listed in Table 14.
Table 14. Processing in-doubt events
Value of "inDoubtEvents" | Action to take |
---|---|
FailOnStartUp | Log a fatal error and terminate. |
Reprocess | Publish the event to the broker like a normal event. |
LogError | Ignore the event and log an error. |
Ignore | Ignore the event. |
Several errors may occur in the polling process. The most common are
listed in Table 15.
Table 15. Processing polling errors
Error | Action |
---|---|
Cannot publish event because it is not subscribed. |
Logs an error message, may archive the event, and continues processing events. |
Cannot publish event because connector controller is not active. | Sets event status to 0 and returns SUCCESS code. |
Error is specific to this event, for example, invalid value specified in event. |
Logs an error message, may archive the event, and continues processing events. |
Broker rejects event with an error message. | Logs an error message, may archive the event and the error
message, and returns FAIL code. |
Cannot communicate with eMatrix; other
unrecoverable errors | Logs a fatal error messages and returns
APPRESPONSETIMEOUT code |
The adapter requires a unique business object ID or combination of values (type, name and revision) to identify a business object. If the values that are supplied are incorrect or do not match any existing business object, an error is reported.
These are some of the most common verb processing errors. For a full list, refer to the IBM WebSphere Business Integration Connector Development Guide for Java or for C++.
If a business object with the specified values already exists, the adapter
returns VALDUPES and does not create the new business object.