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

  1. Perform one of the following:The symptom database editor opens the overview of the selected database.
  2. Select the Details tab.
  3. Select the root entry in the tree.
  4. 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.
  5. Right click, then select Add SolutionEither replace the Solution name and add the Description or
    select an existing solution.  Click here:

    Drop down box labelled Solution name, prefilled with <new solution>

    And select from the list of existing solutions:

    Drop down box fully open showing a list of solutions

    Each symptom must have at least one solution.  The solution is a general statement of how to deal with the symptom.
  6. 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.
  7. 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

  1. From Resource perspective, in the Navigator view, select the required database.  It must have been imported and must must have the .trcdbxmi extension.
  2. Double-click. The symptom database editor opens the overview of the selected database.
  3. Select the Details tab.
  4. 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.
  5. Edit fields, as required.
  6. Save your updated entry: Ctrl+S.

Updating the properties of the database

  1. Select the top-level node of the database in the tree. The database's properties appear to the right.
  2. 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.
  3. 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