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. 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 5 describes the types of tracing messages that the connector outputs at each trace level. All the trace messages appear in the file specified by the connector property TraceFileName. These messages are in addition to any tracing messages output by the IBM WebSphere Business Integration Adapter architecture.

Table 5. 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 BO sent to the broker
  • Trace dumps of BO sent by the broker

Copyright IBM Corp. 1997, 2004