Analysis Unit editor


This section provides a detailed description of the Analysis Unit editor. This editor essentially provides a means for you to create a new Analysis Unit or edit the configuration of an existing or auto-created Analysis Unit.

Notes

The above screen shot shows the Analysis Unit editor for a J2EE Analysis Unit.

Name Displays the name of your Analysis Unit:
  • In the case of newly created Analysis Units, this will be displayed as New XXX Analysis Unit (where XXX corresponds to the Technology type) and all other fields will be empty
  • In the case of existing Analysis Units that have been defined automatically, the name is determined by the CAST Management Studio and the CAST Delivery Manager Tool, using the name of the corresponding project. For example, for J2EE based source code, the name defined in the <name> tags of a .project file will be used:
    <?xml version="1.0" encoding="UTF-8"?><projectDescription> <name>CastPubs</name> <comment></comment> <projects></projects> <buildSpec>  <buildCommand>   <name>org.eclipse.jdt.core.javabuilder</name>   <arguments></arguments>  </buildCommand> </buildSpec> <natures>  <nature>org.eclipse.jdt.core.javanature</nature> </natures></projectDescription>

You can edit the field by selecting it and then modifying or replacing as appropriate. Please see Naming constraints for more information.

Notes

  • The Name of a database type Analysis Unit is not visible and cannot be edited.
Analysis Unit Description Use this area to make notes or remarks about the item.
Source Settings tab

The options in these tabs are explained below:

Analysis tab

The options in these tabs are explained in the relevant Technology editors.

Production tab

The Production tab only contains a Dynamic Links Rules section. It allows you to assign a Dynamic Link Manager rule file (*.DLM.XML file) to the Analysis Unit. The interface is explained in the Application editor Production tab.

You can find out more information about Dynamic Link Manager rule files here: Dynamic Link Manager filter rules.

Execute tab

Options

Run Analysis on the current analysis unit's group This option will run an analysis on the current Analysis Unit and save the results to the CAST Analysis Service. Any associated Analysis Unit's in the current Analysis Unit's parent Execution Unit will also be analyzed to maintain consistency of the analysis results - in other words, the results produced by this option will be identical to the results produced when generating a snapshot that includes the current Analysis Unit.

However, please note that if the current Analysis Unit is used as a target for a Dependency Rule in the parent Application, then any other Analysis Units involved in the Dependency Rule will not be re-analyzed - therefore results (i.e. links between objects) may be incomplete - if this is the case, the following message will be displayed:

Analysis Unit 'XXX' is the target of a Dependency Rule involving other Analysis Units within the application.These other Analysis Units will not be re-analyzed, therefore the results may be incomplete.

Additionally, these missing dependencies are logged in CAST-MS.log.txt with the following format:

Dependencies are missing from analysis: XXX. This might cause the absence of links to these dependencies.
Test Analysis on the current analysis unit's group This option is identical to the Run Analysis on the current analysis unit's group option described above but no results will be saved to the CAST Analysis Service. This is purely for testing the analysis can run without error: you can consult the log files to resolve an issue before you use the run an analysis option or Generate a Snapshot, both of which will save the results to the Analysis Service.
View Analysis Unit content This option will show the objects that have been saved to the CAST Analysis Service on successful completion of an analysis. Note that no information will be visible if you have only used the Test analysis option.

Analysis Unit implementation

Analyze Analysis Unit Allows you to include/exclude the current Analysis Unit from an analysis.
  • Checked > The Analysis Unit will be included in the analysis
  • Unchecked > The Analysis Unit will NOT be included in the source code analysis. This is usually done to temporarily remove an Analysis Unit from the Application and hence from the source code analysis. Note that you should delete the Analysis Unit in the Current Version tab of the Application editor if you want to permanently remove an Analysis Unit from the Application.

Notes

Execution Unit annotation See Working with Execution Units for more information.

Only available in some Analysis Units (for technologies that support Execution Units).

Code Size (bytes)
Is Application entry point
Don't show in the Dashboard This option allows you to flag objects in the Analysis Unit as "external":
  • Checked > The corresponding Analysis Unit and its objects WILL be analyzed so as to avoid link resolution errors and will thus be visible in CAST Enlighten, however, the objects resulting from the analysis of the Analysis Unit will be flagged as "external" and WILL NOT contribute to any calculations executed for the CAST Health Dashboard/CAST Engineering Dashboard and WILL NOT figure in any results displayed in the CAST Health Dashboard/CAST Engineering Dashboard.
  • Unchecked > The corresponding Analysis Unit and its objects WILL be analyzed so as to avoid link resolution errors and will thus be visible in CAST Enlighten. Objects resulting from the analysis of the Analysis Unit WILL contribute to any calculations executed for the CAST Dashboard and WILL figure in any results displayed in the CAST Health Dashboard/CAST Engineering Dashboard.

This option will be checked automatically for Analysis Units whose corresponding projects have been excluded (marked as Ignored) in the CAST Delivery Manager Tool, and where one or more dependent projects in the same source code package are included (marked as Selected). There is more information about this in the CAST Delivery Manager Tool help.

Last Execution Summary

Last Execution Status Displays the status of the most recent execution (as part of a snapshot or standalone analysis) of the current Analysis Unit.
Last Execution Date Displays the date of the most recent execution (as part of a snapshot or standalone analysis) of the current Analysis Unit.
Last Execution Log Displays the location of the analysis log for the most recent execution (as part of a snapshot or standalone analysis) of the current Analysis Unit. Click the Open button to display the log.
Editor buttons

The following buttons are available in the view:

Minimize > Minimize the entire window
Maximize > Maximize the entire window
See Also

Application editor


CAST Website