Using log and trace files

The adapter components provide several levels of message logging and tracing.

The connector uses the adapter framework to log error, informational and trace messages. Error and informational messages are recorded in an external log file, and the trace messages and trace level (0 to 5) are recorded in a trace file. The default message file name is eMatrixConnector.txt.

Table 10 describes the type of messages logged at each tracing level.


Table 10. Trace file tracing levels

Trace Level Description
0
  • Logs errors and fatal errors from the eMatrix ODA
  • Logs warnings that require a system administrator's attention
  • Logs important messages from the application

1 Traces all entering and exiting messages for method
2 Traces the ODA's properties and their values
3 Traces the names of all business objects
4 Traces business object properties and the values received
5
  • Indicates the ODA initialization values for all of its properties
  • Traces the business object definition dump

You configure both the log and trace files names, as well as the trace level, in Connector Configurator. Refer to Appendix B, "Connector Configurator" for details.

The ODA has no logging capability; error messages are sent directly to the user interface. Trace files and the trace level are configured in Business Object Designer. The process is described in Configure the agent. The ODA trace levels are the same as the connector trace levels, shown in Table 10 above.

For more details on error handling and troubleshooting, refer to "Troubleshooting and error handling".

Copyright IBM Corp. 1997, 2003