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 7 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 Server
Express adapter architecture.
Table 7. 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
|
