Tracing messages

Tracing is an optional debugging feature you can turn on to closely follow the connector's behavior. Tracing messages are configurable and can be changed dynamically. You set various levels depending on the desired detail. See Setting trace/log file values for information on specifying tracing information.

The following sections describe tracing for the TCP/IP adapter.

Recommendation: Tracing should be turned off on a production system or set to the lowest possible level to improve performance and decrease file size.

Using tracing with the connector

Trace messages, by default, are written to STDOUT (screen). You can also configure tracing to write to a file.

Table 6 describes the types of tracing messages that the connector outputs at each trace level. These messages are in addition to any tracing messages output by the IBM WebSphere Business Integration Adapter architecture.

Table 6. Tracing messages for the connector
Tracing level Tracing messages
Level 0 Trace adapter version
Level 1
  • Trace each time pollForEvents method is called.
  • Trace each time the adapter accepts a new socket connection in TCP/IP server mode.
  • Trace each time the adapter attempts a new socket connection in TCP/IP client mode.
  • Trace ASBO/ISBO name created by adapter to deliver to broker.
  • Trace request ASBO/ISBO name created by broker to deliver to adapter.
Level 2
  • Trace each time doVerbFor () is called. Trace which Protocol Handler is processing this request.
  • Trace each time executeCollab() or gotApplEvent() is called.
Level 3
  • Trace important ASI of the business object being processed.
  • Trace important attributes of the business object being processed.
  • Trace all data that passes through the TCP channel in both directions.
    Note: The data will be formatted as hexadecimal.
Level 4
  • Trace spawning of threads.
  • Trace all ASI processed.
  • Trace entry and exit of important functions.
Level 5
  • Trace entry and exit for each important method.
  • Trace all the Adapter properties.
  • Trace dumps of business object sent to the broker.
  • Trace dumps of business object sent by the broker.

Copyright IBM Corporation 1997, 2005. All Rights Reserved.