Capturing a trace

BARR/CHANNEL Offload provides the ability to capture several types of traces. You can capture a trace of the IP network, channel adapter, or perform internal tracing of the service. Network and channel tracing can also be configured to occur automatically when the connection is started.

Use the following links to learn how to perform tracing.

You must be a member of the local Administrators group to capture a trace.

Tracing may cause performance degradation and should only be used for troubleshooting purposes.

See also:


Network or channel tracing

You can capture a trace of the IP network or channel adapter from the BARR/CHANNEL Offload window. When capturing a channel adapter trace, all connections using the selected adapter will be traced. Complete the following steps to capture a network or channel trace.

  1. Open BARR/CHANNEL Offload.

  2. Select the connection you want to trace.

  3. Use one of the following methods to start the connection.

  4. On the menu bar, select Connection | Start.

  5. Right-click the connection and select Start.

  1. Use one of the following methods to start the trace.

  2. For a network trace, on the menu bar, select Trace | Network | Long Format or Short Format, depending on how detailed you want the trace to be. You can also right-click the connection and select Network Trace | Long Format or Short Format.

  3. For a channel adapter trace, on the menu bar, select Trace | Channel | Long Format or Short Format, depending on how detailed you want the trace to be. You can also right-click the connection and select Channel Trace | Long Format or Short Format.

  1. Recreate the problem. The trace file is saved in the \\Program Files\Common Files\Barr\Trace folder. The trace file name will be the name of the service, with an .ipt extension for network traces and a .chi extension for channel traces. Each connection is saved as a Windows service. Services are named as follows, BarrTOS/AdapterNumber-ImageNumberChannelAddress (for example, BarrTOS/0-00E). If you are using a Bus & Tag adapter, the image number will not appear.

  2. Use one of the following methods to stop the trace.

  3. For a network trace, on the menu bar, select Trace | Network | Off. You can also right-click the connection and select Network Trace | Off.

  4. For a channel adapter trace, on the menu bar, select Trace | Channel | Off. You can also right-click the connection and select Channel Trace | Off.

  1. Use the Diagnostics Utility to send the trace file and any additional information to Barr Systems Technical Support.

Network and channel tracing can be configured to occur when the connection is started. On the Advanced tab, select Short or Long from the Startup tracing drop-down list.

Channel traces can also be captured from the BARR/CHANNEL-IN utility.

Internal tracing

Internal tracing should only be performed if a Barr Systems support analyst advises you to do so.

Complete the following steps to capture an internal trace of the service.

  1. Open BARR/CHANNEL Offload.

  2. Select the connection you want to trace.

  3. Use one of the following methods to start the connection.

  4. On the menu bar, select Connection | Start.

  5. Right-click the connection and select Start.

  1. Select the connection and click Connection | Modify on the menu bar, or right-click the connection and select Modify.

  2. Select the Advanced tab.

    Advanced Tab

  3. Set the Internal tracing drop-down list to On. This will capture a trace of the internal state of the system.

  4. Recreate the problem. The trace file is saved in the \\Program Files\Common Files\Barr\Trace folder. The trace file name will be the name of the service, with an .int extension. Each connection is saved as a Windows service. Services are named as follows, BarrTOS/AdapterNumber-ImageNumberChannelAddress (for example, BarrTOS/0-00E). If you are using a Bus & Tag adapter, the image number will not appear.

  5. To stop the trace, from the Advanced tab set the Internal tracing option to Off.

  6. Use the Diagnostics Utility to send the trace file and any additional information to Barr Systems Technical Support.