Editing a symptom database
You can edit a symptom database file within the workbench using the symptom
database editor. You would edit the database because over time, symptoms, solutions or
directives are discovered and they change.
Adding entries to the database
- Perform one of the following:
- From the Resource perspective, in the Navigator view,
duble-click the required database. It must have been imported and must must have
the .trcdbxmi extension.
- In the Log Navigator view under the symptom databases folder,
right-click the symptom database and select Open.
The symptom database editor opens the overview of the selected database.
- Select the Details tab.
- Select the root entry in the tree.
- Right click, then select Add Symptom. Replace the Symptom name,
if needed, and the Match Pattern, which is used to match the entries with
unique patterns in the log file entries.
- Right click, then select Add Solution. Either replace the
Solution name and add the Description or
select an existing solution. Click here:

And select from the list of existing solutions:

Each symptom must
have at least one solution. The solution is a general statement of how
to deal with the symptom.
- Optionally, right click, then select Add Directive. Replace
the Directive name, add the Description, and, optionally, add the name of
the First Failure Data Capture diagnostic module FFDC string field.
The FFDC string is a class or method that is to be called when a failure event
is captured.
- Save your new entry: Ctrl+S.
Tip: In the Log view, in the Log Records pane, if you right-click on
a log record and select Copy to Clipboard, the message (msg) property
of that log record is copied to the clipboard. This is useful for pasting into
filter and symptom database editors.
Editing database entries
- From Resource perspective, in the Navigator view, select the required database.
It must have been imported and must must have
the .trcdbxmi extension.
- Double-click. The symptom database editor opens the overview of the selected database.
- Select the Details tab.
- Select the database entry in the tree. The entry's properties are
displayed to the right. Expand the tree to expose the solution and
directive, if needed.
- Edit fields, as required.
- Save your updated entry: Ctrl+S.
Updating the properties of the database
- Select the top-level node of the database in the tree. The database's
properties appear to the right.
- Update fields, as required. If you change the name or path of the
database this information appears only in the database itself. A new database
is not created.
- Save your update: Ctrl+S. The next two fields, the URL and External location fields
are for informational purposes only. These fields are editable.
Related concepts
The symptom database
The symptom database editor
Log and Trace Analyzer
Related tasks
Importing
and using a symptom database
Creating a symptom database
Exporting a symptom database
(C) Copyright IBM Corporation 2000, 2004. All Rights Reserved.