Rational Developer for System z

Working with histories and results

The Software Analysis Results view displays the results of a code review.

The results of a code review are stored in a history. In the Software Analysis Results view you can select a history to work with, study the contents of a history, and fix code review problems described in a history.

Persistence of histories, results, and reports

The histories and results generated by a code review are retained so long as Developer for System z® remains open:
  • The histories are displayed in reverse chronological order in the left pane of the Software Analysis Results view.
  • The results of the currently selected history are displayed in the right pane of the same view.
  • The icons and text highlighting used to mark source code problems are displayed in the source code files by the COBOL or PL/I editor and by the System z LPEX editor.
These items are lost when Developer for System z closes.
Note: You can preserve a history and its component results by creating a report in HTML or PDF format and saving the report to the workstation's file system.
Note: Software analysis configurations, including built-in rules, custom rules, and user-written rules are persistent across opens and closes of Developer for System z. Also:
  • You can export or import software analysis configurations between the configuration editor and the workstation's file system.
  • You can use the push-to-client components to distribute configurations from z/OS® servers to client workstations.

Selecting a history

The left pane of the Software Analysis Results view lists the histories of the code reviews run since Developer for System z was opened. Each history is a compilation of the results from a single code review. Figure 1 shows an example of a list entry for a history.

The entry contains the name of the analysis configuration used (Cobol Tool Dev 041), the time and date of the code review, the number of individual results in the history (38), and the processing time for the code review (0 milliseconds):
Figure 1. Left pane: List entry for a history
  • COBOL Tool Dev 041 (12/05/13 14:41:35) [38 results in 0 ms]
To view the contents of a history:
  1. In the left pane, select the history.
  2. The results in the history are displayed in the right pane.
Other operations you can perform on a history:
  • To delete the history, right-click the entry and click Delete.
  • To generate a report, right-click the entry and click History Reporting.

Viewing the results in a history

The right pane of the Software Analysis Results view displays the results from whichever history is selected in the left pane.

The results are grouped according to category (such as Naming Convention, Performance, and so on), rule, source file name, and line number. Figure 2 shows an example of part of a listing:
Figure 2. Right pane: List entry for an individual result
  • Right pane: List entry for a results

In the figure the rule category is Program Structures, a built-in category. The rule is Avoid ACCEPT statements, a built-in rule, which has been assigned a severity of Warning, indicated by the icon Warning. Below the rule are listed two results, each result referring to a source code location where a problem of this type was found. Each result contains the severity icon of the rule, the source code file name, the line number, and the text of the rule.

You can filter the results by clicking a button on the toolbar:
Table 1. Filtering the results of an analysis
Button: Effect: Action:
Filter All Filtering is off. Display all the rules and categories specified in the code review configuration.
Filter Results Filtering is on. Display only the rules and categories for which results are found.


Feedback