Review Tool

The Review Tool

The Review Tool assists you in debugging your Post program.

The review tool can be found in the TCL file named mom_review.tcl.

The Post review tool allows you to view the events, their associated variables and addresses, as well as the output generated by the Post program in a single window.

Activating the Review Tool

To activate the Review Tool, two things must be done.

First, the file mom_review.tcl must be "sourced" at the beginning of the event handler file. This file contains the review tool and should be specified with the complete path, as shown in the following example:

source /usr/eds105/mom_tools/mom_review.tcl
source ${cam_debug_dir}mom_review.tcl

Second, the debug mode must be turned on by placing the following command immediately after the "source mom_debug.tcl" statement in the event handler.

MOM_set_debug_mode ON

To have the review tool available at all times in the event handler, place these statements in the script, but outside of the procedure.

After after activating the review tool as described above, the dialog shown in the following figure is displayed when the postprocessor is executed.

The Review Tool Dialog

The Debug dialog allows you to specify the type of information that you want to see for each event.

Review Tool

The Post Review Tool dialog consists of three list boxes, each having horizontal and vertical scroll bars to assist you in viewing the information.

The left list box displays all the events in the sequence they have been triggered during processing. Each event is displayed with the appropriate event number.

The center list box displays the variables and addresses associated with a particular event.

The right list box displays the output generated by the postprocessor.

The Review Tool dialog options are described as follows:

Range of Events

By switching this toggle button ON and specifying the "From" event number and the "To" event number and choosing OK, you can display only the events occurring within the specified range. The information related to events occurring outside of the specified range will not be displayed.

OK

Causes the specified range of events and associated information to be displayed.

EXIT

Allows you to exit the Review Tool and return to NX.

Using the Review Tool

Selecting an event in the left list box will cause the review tool to display the event, with its associated variables and addresses and the values assigned to them, in the center list box. The output generated from the event is highlighted in the right list box.

If no output is generated from an event, the words "No Output From Event" is highlighted in the right list box.

Selecting a line of output in the right list box will cause the review tool to display the event that generated it with its associated variables and addresses and the values assigned to them in the center list box. This allows you to quickly determine the events, variables and addresses used in generating the output.

Selecting a variable listed in the center list box will cause the review tool to display in the left list box, the value assigned to that variable by each event that uses the variable. This allows you to see how the selected variable is assigned values across various events.