Specifications

170 System Software Diagnostics Guide — September 2006
RTFManager Reference
• Errors - Traces the following labels: ERR1, ERR2, EXCE, and EINF. This is the lowest
slider setting, so these tags are always traced.
• Warnings - Traces the WARN label in addition to the Error labels.
• Program Flow - Traces the INTF, INFO, and APPL labels in addition to the Warning and
Error labels.
• Debugging - Traces the DEBG label in addition to the Program Flow, Warning, and Error
labels. All trace labels are enabled at this level.
Note: Alternatively, you can click on any one of the label buttons to set all sliders to the
given level.
3. When you have finished setting the trace levels, click OK.
4. You can then start your application (if it not already running). Trace output will appear in a log
file. You can display the log file in the Runtime Trace Facility Manager main window using
the File -> Open menu item. Furthermore, you can use the Runtime Trace Facility Manager
main window to only display select trace output statements.
29.7 Log File Filtering
The Runtime Trace Facility Manager provides a log file filtering mechanism that allows you to
customize the log file so that only certain trace statements are displayed. Use the following
procedure to filter the log file:
1. In the Runtime Trace Facility Manager main window, select File -> Open to open an existing
RTF log file.
2. Select Tools -> Filter... The Filters dialog box appears. The Filters dialog box lists any filters
you currently have set up in the Runtime Trace Facility Manager.
3. In the Filters dialog box, click the New button. The New Filter window appears.
4. Select Module, Client or Label from the New Filter window’s drop-down menu, depending
on which element you’d like to view on the log file.
5. In the New Filter window’s text box, type the name of the Module, Client or Label you’d like
to view in the log file.
6. Click OK.
7. The newly created filter will be added to the list in the Filters window. Keep in mind that when
more than one filter is shown, they are AND’ed together. For example, if you have the
following filters setup:
• Module is equal to gc
• Label is equal to DEBG
8. Then the log file will only show the trace statements that contain the gc module and the DEBG
label.
9. The log file will refresh and display its contents according to the filters you have set up.
10. If you subsequently modify or delete filters, the original data is re-filtered based on the latest
set of filters. The original log file is left unchanged unless you choose to save it using the File
-> Save or File ->Save As menu items.