Locating diagnostic files

Technical Support

Select the type of file you would like to include with the diagnostics.

See also:

802.2 trace

If you have communication problems, you can capture an 802.2 trace.

Complete the following steps to generate a program trace.

  1. Open the RJE Configuration Utility.

  2. Select the Communication Link tab.

    Communication Link Tab

  3. Under Link options, select an 802.2 link and click Modify.

  4. The BARR/SNA 802.2 Link Service utility displays.

  1. From the Trace tab, select Trace enabled.

  2. Specify the Trace format, either long or short, and the Max tracefile size.

  3. Recreate the problem or software event.

  4. Clear the Trace enabled check box to stop the trace. The trace results are saved to a text file. By default, the file will be saved in the \\Program Files\Common Files\Barr\Trace folder.

  5. Click OK or Cancel to close the utility.

  6. Capture diagnostics with the Diagnostics Utility. This file will be automatically included.

HPR/IP trace

If you have communication problems, you can capture an HPR/IP trace.

Complete the following steps to generate a program trace.

  1. Open the RJE Configuration Utility.

  2. Select the Communication Link tab.

    Communication Link Tab

  3. Under Link options, select an HPR/IP link and click Modify.

  4. The BARR/SNA HPR/IP Link Service utility displays.

  1. From the Trace tab, select Trace enabled.

  2. Specify the Trace format, either long or short, and the Max tracefile size.

  3. Recreate the problem or software event.

  4. Clear the Trace enabled check box to stop the trace. The trace results are saved to a text file. By default, the file will be saved in the \\Program Files\Common Files\Barr\Trace folder.

  5. Click OK or Cancel to close the utility.

  6. Capture diagnostics with the Diagnostics Utility. This file will be automatically included.

SDLC trace

If you have communication problems, you can capture an SDLC trace.

Complete the following steps to generate a program trace.

  1. Open the RJE Configuration Utility.

  2. Select the Communication Link tab.

    Communication Link Tab

  3. Under Link options, select an SDLC link and click Modify.

  4. The BARR/SNA SDLC Link Service utility displays.

  1. From the Trace tab, select Trace enabled.

  2. Recreate the problem or software event.

  3. Clear the Trace enabled check box to stop the trace. The trace results are saved to a text file. By default, the file will be saved in the \\Program Files\Common Files\Barr\Trace folder.

  4. Specify the Trace format, either long or short, and the Max tracefile size.

  5. Click OK or Cancel to close the utility.

  6. Capture diagnostics with the Diagnostics Utility. This file will be automatically included.

CHANNEL-OUT trace

If you have communication problems, you can capture a CHANNEL-OUT trace.

Complete the following steps to generate a program trace.

  1. Open the BARR/CHANNEL-OUT utility.

  2. Select the Tracing tab.

    Tracing Tab

  3. Click Start.

  4. Print a file to a PRINT390 printer.

  5. Click Stop when you are finished tracing.

  6. Click Save.

  7. In the File name box, type the file name and click Save. By default, the file will be saved in the \\Program Files\Common Files\Barr\Trace folder, unless an alternate path is specified.

  8. Run the Diagnostics Utility and add this trace file. You can use the Windows Find feature to search for the trace file. For more information, see the Microsoft Help.

LPD trace

  1. Open the BARR/PRINT TCP/IP Configuration utility.

  2. Select the LPD tab.

    LPD Tab

  3. Under Trace controls, verify the File name of the trace file.

  1. Click Start.

  2. Receive a file with LPD.

  3. Click Stop when you are finished tracing. The trace file is automatically stored in the \\Program Files\Common Files\Barr\Trace folder.

Leaving the LPD trace running can greatly degrade performance. The LPD trace is intended as a diagnostic tool only and must not be used in production settings. If you close the BARR/PRINT TCP/IP Configuration utility while the trace is running, a message will ask you if you want to stop the trace.

  1. Capture diagnostics with the Diagnostics Utility. This file will be automatically included.

TCP/IP socket trace

  1. Open the BARR/PRINT TCP/IP Configuration utility.

  2. Select the Socket tab.

    Socket Tab

  3. Under Trace controls, verify the File name of the trace file.

  1. Click Start.

  2. Receive a file with TCP/IP socket.

  3. Click Stop when you are finished tracing. The trace file is automatically stored in the \\Program Files\Common Files\Barr\Trace folder.

Leaving the trace running can greatly degrade performance. The trace is intended as a diagnostic tool only and must not be used in production settings. If you close the BARR/PRINT TCP/IP Configuration utility while the trace is running, a message will ask you if you want to stop the trace.

  1. Capture diagnostics with the Diagnostics Utility. This file will be automatically included.

Spooled file

  1. Open the Spool Window.

  2. Right-click the job you want to include in the diagnostics.

  3. Select Add to Diagnostics.

  4. Run the Diagnostics Utility.

Raw spooled file

  1. Open the BARR/PRINT TCP/IP Configuration utility.

  2. Click Add and type a queue name where LPR can print.

  3. Click Add to define the queue.

  4. From the File type list, choose <Default>.

  5. Under Receive as, select Binary (raw).

  6. Click OK.

  7. Using LPR, send a file to the queue name added in step 2.

  8. Use one of the following methods to send the file to Barr Technical Support.

Resulting file

  1. Open the Diagnostics Utility.

    Diagnostics Utility

  2. In the Name box, type the name of the contact person. This is a required field.

  3. In the Phone box, type the phone number of the contact person. This is a required field.

  4. In the Comments box, type your assigned problem tracking number and a brief description of the problem.

  5. Click Add Files and select the resulting file that was written to disk.

  6. Click Start. The status of the progress of the diagnostics being gathered will be indicated in the Status box. The name and location of the compressed Reduced the amount of space or bandwidth needed to store or transmit a block of data. Data compression is also called data compaction. .bct file will display, indicating that all diagnostics have been collected.

  7. To view the details of the diagnostics, click View Log.

  8. To save the BarrDiag.bct file to an alternate location, click Save As. This is useful because the BarrDiag.bct file is saved to a hidden folder by default.

  9. Use one of the following methods to send the files to Barr Technical Support.

Original file

  1. Open the Diagnostics Utility.

    Diagnostics Utility

  2. In the Name box, type the name of the contact person. This is a required field.

  3. In the Phone box, type the phone number of the contact person. This is a required field.

  4. In the Comments box, type your assigned problem tracking number and a brief description of the problem.

  5. Click Add Files and select your original file before it was sent to the spool.

All trace files located in the \\Program Files\Common Files\Barr\Trace folder will be included in the diagnostics. Once the files are included in the trace, they will be moved to the \\Program Files\Common Files\Barr\Old Trace folder. If a file with the same name exists in the Old Trace folder, the existing file is replaced with the new file.

  1. Click Start. The status of the progress of the diagnostics being gathered will be indicated in the Status box. The name and location of the compressed Reduced the amount of space or bandwidth needed to store or transmit a block of data. Data compression is also called data compaction. .bct file will display, indicating that all diagnostics have been collected.

  2. To view the details of the diagnostics, click View Log.

  3. To save the BarrDiag.bct file to an alternate location, click Save As. This is useful because the BarrDiag.bct file is saved to a hidden folder by default.

  4. Use one of the following methods to send the files to Barr Technical Support.