Tracing

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

Table 10 lists the recommended content for connector tracing message levels.

Table 10. Tracing messages content

Level Description
Level 0 Use this level for trace messages that identify the connector version. No other tracing is performed at this level.
Level 1 Use this level for trace messages that:
  • Provide status information.
  • Provide key information on each business object processed.
  • Record each time a polling thread detects a new message in an input queue.
Level 2 Use this level for trace messages that:
  • Identify the BO handler used for each object that the connector processes.
  • Log each time a business object is posted to the integration broker.
  • Indicate each time a request business object is received.
Level 3 Use this level for trace messages that:
  • Identify the foreign keys being processed, if applicable. These messages appear when the connector has encountered a foreign key in a business object or when the connector sets a foreign key in a business object.
  • Relate to business object processing. Examples of this include finding a match between business objects, or finding a business object in an array of child business objects.
Level 4 Use this level for trace messages that:
  • Identify application-specific information. Examples of this include the values returned by the methods that process the application-specific information fields in business objects.
  • Identify when the connector enters or exits a function. These messages help trace the process flow of the connector.
  • Record any thread-specific processing. For example, if the connector spawns multiple threads, a message logs the creation of each new thread.
Level 5 Use this level for trace messages that:
  • Indicate connector initialization. This type of message can include, for example, the value of each connector configurator property that has been retrieved from the broker.
  • Detail the status of each thread that the connector spawns while it is running.
  • Represent statements executed in the application. The connector log file contains all statements executed in the target application and the value of any variables that are substituted, where applicable.
  • Record business object dumps. The connector should output a text representation of a business object before it begins processing (showing the object that the connector receives from the collaboration) as well as after it finishes processing the object (showing the object that the connector returns to the collaboration).

Copyright IBM Corp. 1997, 2004