Rational Developer for System z

Creating a software analysis configuration

This topic describes how to create a software analysis configuration.
Follow these steps:
  1. Open the software analysis configuration editor (see Opening the software analysis configuration editor).
  2. In the left pane of the editor, create a new software analysis configuration, or create one based on an existing configuration.
    • Creating a new configuration: To create a new software analysis configuration, perform one of the following tasks:
      • Click New launch configuration on the toolbar.
      • Right-click any node in the Software Analyzer tree and then click New.
      • Double-click the Software Analyzer node at the top of the tree.
    • Duplicating a configuration: To create a configuration based on an existing one, perform one of the following tasks:
      • Select the existing configuration in the Software Analyzer tree and then click Duplicate on the toolbar.
      • Right-click the existing configuration in the Software Analyzer tree and then click Duplicate.
    Note:
    • If the button or the menu item is disabled, then enable it by selecting any node in the Software Analyzer tree.
    • If the Software Analyzer tree is not visible, show it by clearing the filter input field.
  3. In the Name field, type a unique name for the new software analysis configuration or accept the default name.
  4. On the Scope tab, select a scope for the new software analysis configuration. The scope identifies the COBOL source files to which the software analysis is to be applied. Table 1 shows the values that can be selected:
    Table 1. Scope values
    Scope selection: Resulting scope:
    Analyze entire workspace All the COBOL source files in the workspace.
    Analyze a resource working set All the COBOL source files in the selected resource working set.
    Analyze selected projects All the COBOL source files in the selected projects.

    When you run the software analysis configuration you can override the configured scope with a different scope (see Running a software analysis; runtime scope).

  5. On the Rules tab, select the rules that you want to be included in this analysis configuration. The meaning of each rule is described in Description of the COBOL code review rules. Follow these steps:
    1. In the Analysis Domains and Rules tree, expand COBOL Code Review.
    2. Expand a rule category, such as Program Structures.
    3. Select a rule, such as Avoid ACCEPT statements.
    4. On the Properties tab:
      1. Set the severity for the rule. Table 2 shows the values that can be set for severity.
      2. Set the value of any custom parameter.
    Table 2. Severity levels
    Icon Severity level Description
    Recommendation This is the lowest severity level. The result indicates a problem that is not serious but one that you should still fix.
    Warning This severity level indicates that a resource very likely has a problem that you need to resolve.
    Severe This is the highest severity level and indicates that you should resolve the problem.
  6. Apply and Revert:
    • Click Apply to save your changes.
    • Click Revert to undo the changes since the most recent Apply.
  7. Analyze and Close:
    • Click Analyze to close the editor and run the software analysis configuration.
    • Click Close to close the editor.

Feedback