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
To view the contents of a history:
- In the left pane, select the history.
- 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
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
. 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: |
 |
Filtering is off. |
Display all the rules and categories specified
in the code review configuration. |
 |
Filtering is on. |
Display only the rules and categories for which
results are found. |