BARR/PRINT CHANNEL 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 and banner. 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.
You can capture a trace of the IP network or channel adapter from the BARR/PRINT CHANNEL 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.
Open BARR/PRINT CHANNEL.
Select the connection you want to trace.
Use one of the following methods to start the connection.
On the menu bar, select Connection | Start.
Right-click the connection and select Start.
Use one of the following methods to start the trace.
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.
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.
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, BarrPCSAdapterNumber_ImageNumberChannelAddress (for example, BarrPCS0_00E). If you are using a Bus & Tag adapter, the image number will not appear.
Use one of the following methods to stop the trace.
For a network trace, on the menu bar, select Trace | Network | Off. You can also right-click the connection and select Network Trace | Off.
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.
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
Properties dialog box, 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 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 and banner.
Open BARR/PRINT CHANNEL.
Select the connection you want to trace.
Use one of the following methods to start the connection.
On the menu bar, select Connection | Start.
Right-click the connection and select Start.
Select the connection and click Connection | Modify on the menu bar, or right-click the connection and select Modify.
On the Communications tab, click Advanced. The Advanced Properties dialog box displays.
From the Internal tracing drop-down list, select Service trace to capture a trace of the internal state of the system, Banner trace to capture a trace to assist in the debugging of banner processing, or Both to capture both a service and banner trace.
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, BarrPCSAdapterNumber_ImageNumberChannelAddress (for example, BarrPCS0_00E). If you are using a Bus & Tag adapter, the image number will not appear.
To stop the trace, from the Advanced Properties dialog box set the Internal tracing option to Off.
Use the Diagnostics Utility to send the trace file and any additional information to Barr Systems Technical Support.