By using the RJE Diagnostics utility you can monitor communication between the personal computer and the host computer. This topic provides information on using the features of the RJE Diagnostics utility.
Before you can use the RJE
Console, you must follow the steps in the Getting
started with BARR/RJE topic and be connected
to the host. If you encounter a problem during initial connection, we
recommend starting
the RJE Diagnostics utility before starting the connection from the RJE
Console.
The RJE Diagnostics utility is made up of three components: the communication scope, link statistics, and bind data. Once you have opened the RJE Diagnostics utility, you can display or hide any combination of these components.
To hide the communication scope, on the menu bar, select View | Communication Scope | None. To display the communication scope using color to indicate the connection type, on the menu bar, select View | Communication Scope | Color. To display the communication scope using position to indicate the connection type, on the menu bar, select View | Communication Scope | Monochrome.
When in color mode, the colors that display
match the colors configured
in the RJE Console
window.
To display or hide the link statistics, on the menu bar, select View | Link Statistics.
To display or hide the bind data, on the menu bar, select View | Bind Data.
You can use the RJE Diagnostics utility to create a trace file of BARR/RJE program activity. If you have trouble operating BARR/RJE and contact Barr Technical Support, a support analyst may request that you create and send a trace file to determine the cause of the problem.
You can capture a trace for 802.2, HPR/IP, and SDLC connections. MS/LUA traces must be captured from either Microsoft SNA Server or HIS. Refer to the appropriate Microsoft Help for more information.
If you encounter
a problem during initial connection, we recommend starting
the RJE Diagnostics utility before starting
the connection from the RJE
Console.
Open the RJE Diagnostics utility.
On the menu bar, select Trace | Start.
Perform the operation that you want to trace.
To stop writing BARR/RJE operations to the trace file, on the menu bar, select Trace | Stop. The trace file will be saved in the \\Program Files\Common Files\Barr\Trace folder.
To
view the current trace information, while minimizing the chance of losing
important data, click the Stop Trace
toolbar button and then immediately click the Start
Trace toolbar button to continue tracing.
To clear the contents of the trace file, on the RJE Diagnostics menu bar, select Trace | Clear or click the Clear Trace toolbar button. If you are troubleshooting a specific operation, it can be helpful to clear the trace file before you perform the operation. This way, the trace file will not contain a lot of extraneous information.
To save the contents of the RJE Diagnostics window, on the RJE Diagnostics menu bar, select File | Save or click the Save toolbar button. The following information is saved to the log file, the most recent communication scope history, current link statistics, bind data, internal LU dump (including buffer and queue information), and internal device dump (including buffer and queue information). The file will be saved in the \\Program Files\Common Files\Barr\Log folder. The file name will be ConnectionName_DiagLogN.txt, where N will be populated with a value from 0 to 9, incrementing each time a new file is saved.
To print the contents of the RJE Diagnostics window, on the RJE Diagnostics menu bar, select File | Print.
To reset the link statistics and the communication scope, on the RJE Diagnostics menu bar, select View | Reset. If you are troubleshooting a specific operation, it can be helpful to reset the link statistics and the communication scope before you perform the operation. This will make it easier to monitor the results of the operation on the communication scope or link statistics.