Tracing

Tracing is an optional debugging feature you can turn on to closely follow connector behavior. Trace messages, by default, are written to STDOUT. See the connector configuration properties in Installing and configuring the connector for more on configuring trace messages. For more information on tracing, including how to enable and set it, see the Connector Development Guide.

What follows is recommended content for connector trace messages.

Level 0
This level is used for trace messages that identify the connector version.
Level 1
Use this level for trace messages that provide key information on each business object processed or record each time a polling thread detects a new message in an input queue.
Level 2
Use this level for trace messages that log each time a business object is posted to an integration broker, each time a request business object is received, or that identify the business object handlers used for each object the connector processes.
Level 3
Use this level for trace messages that provide information regarding message-to-business-object and business-object-to-message conversions or provide information about the delivery of the message to the output queue.
Level 4
Use this level for trace messages that identify when the connector enters or exits a function, to identify application-specific information (for example, the values returned by the methods that process the ASI fields in business objects), or to record thread-specific processing (for example, if the connector spawns multiple threads, a trace message can log the creation of each new thread.
Level 5
Use this level for trace messages that indicate connector initialization, represent statements executed in the application, indicate whenever a message is taken off of or put onto a queue, or record business object dumps.

Copyright IBM Corp. 1997, 2003