Overview

Setting up debugging hints is a multi-step process. The first step is to capture the error message. After the error message has been captured, the next step is to use wild card character (i.e., *) to convert the error message into a generic message and save the generic message into the message repository. The third step is to enter the debugging hints and finally, the last step is to remove the original (non-generic) message.

Capturing an error message starts at the Editor. While in the editor, you can right-click and select the Execute Program menu item or click on the Execute Program icon in the tool bar to execute the program that you are editing. Once execution is completed, click on the Visualizer icon on the Navigation Panel.

The Visualizer, in addition to displaying the Program Flow or Data Flow, parses the log file and identifies any potential bugs—that is, code that has generated warnings or errors. It highlights any icon containing problematic code in red as shown below.

To view the error message, click the highlighted icon and the error message with the corresponding code will be displayed in the Code & Log window shown below.

Step 1: Capture the error message.

To capture an error message, click on the ERROR keyword in the Code & Log window to activate the Debugging Hints window.

Step 2: Use wild card character (i.e., *) to convert the newly captured error message into a generic message and save the generic message into the message repository.

Click on the Edit button in the Debugging Hints window to activate the Message Manager window and edit the message (as well as enter the debugging hints in Step 3).

Edit the Error Message to make it generic, i.e., replace WORK.JOURNAL1X.data with *.*.*

Step 3: Enter the debugging hints

Click the Apply button then the OK button

Step 4: Remove the original non-generic error message.

Click on the Edit button to activate the Message Manager to remove the non-generic error message.

Click the Delete button to remove the non-generic error message.

Click the OK button to finish.