The TCA display is a graphical representation of the reports generated during runtime. By utilizing this tool, you will be able to view your tca.log files with ease. Much like Insra, TCA allows you to load and save files, browse through source code, and even access online help. In this section:

Accessing the TCA Display

On Windows systems, click the TCA Display icon in the Insure++ tool bar to invoke the TCA display from Visual Studio. You can also call tcaview along with any other command line options from the command line to invoke the display.

On Unix systems, you can call TCA with any other command line option to invoke the TCA display.

The following subset of TCA command line options are meaningful for the graphical tool, while the remaining unsupported ones are silently ignored:

Command	Description
`-df`	Display by function
`-do`	Display by object/class
`-dF`	Display by file
`-dd`	Display by directory
`-ns`	Simple function names. You can only specify one type of function name. If specifying `-ns`, you cannot specify `-ne` or -nm.
`-ne`	Extend function names. You can only specify one type of function name. If specifying `-ne`, you cannot specify `-ns` or `-nm`.
`-nm`	Mangled function names. You can only specify one type of function name. If specifying `-nm`, you cannot specify `-ne` or `-ns`.
`-ff <name>`	Only show coverage related to the function name specified. This option only applies when `-df` is also specified.
`-fo <name>`	Only show coverage related to the object name specified. This option only applies when `-do` is also specified.
`-fF <name>`	Only show coverage related to the file name specified. The full path to the file must also be included. This option only applies when `-dF` is also specified.
`-fd <name>`	Only show coverage related to the directory name specified. This option only applies when `-dd` is also specified.
`-s <keys>`	Sort output by keys (`d`, `F`, `n`, `%`, `#`, `b`, `1`)
`-ct`	Show hit counts in the source browser

Loading a Report File

By default, TCA displays a report based on the log files that were included in the command line when the program was started. Coverage statistics from additional files may be included in the report by clicking Load and selecting a new log file. The data contained in the newly selected log file is combined with the existing data and a new report is generated.

Loading a Report File in Windows

Loading a Report File in Unix

Browsing the Source

Click Browse to generate a new window containing the next level of coverage detail. For example, if you are currently displaying a report “by directory,” clicking Browse will open a new window displaying a report "by file" for that directory. If you click Browse again, you will get another window displaying a report "by function" for the file(s).

Clicking Browse a final time displays the source code itself, annotated with coverage information for each block. Double-clicking on a line in the display is the equivalent to selecting a line and clicking the Browse button.

Browsing sources in Windows

The level of detail displayed may be changed by clicking Reports. A dialog box will appear, allowing you to choose from one of four report types: by directory, by file, by function, or by class.

Sorting

The order in which the coverage information is presented may be modified by clicking on the Sort button. A dialog box will appear in which you can enter the sort keys to be used. Any combination of the following keys may be used.

d - Sorts by directory
F - Sorts by file name
f - Sorts by function name
% - Sorts by coverage percentage
# - Sorts by number of hits
b - Sorts by number of blocks

For example, in order to sort by percent covered and decide collisions by the function name, the sort key string should be %f. The current sort key string is displayed on the status bar.

Message

This button becomes active when TCA cannot perform a given task. Clicking it opens a window that describes the error(s).

Help

Click Help to access this documentation.

Page tree

The TCA Display