QUICK START GUIDE

              Version 6.4
New editions of this guide incorporate all material added or changed since the previous edition.
Update packages may be used between editions. The manual printing date changes when a new
edition is printed. The contents and format of this manual are subject to change without notice.

Generated: 10/1/2017, 8:52 PM

Rev: cb0043d

Part Number: Quick Start Guide for VectorCAST v.6.4

VectorCAST is a trademark of Vector Software, Inc.

© Copyright 2017, Vector Software, Inc. All rights reserved. No part of the material protected by
this copyright notice may be reproduced or utilized in any form or by any means, electronic or
mechanical, including photocopying, recording, or by any informational storage and retrieval
system, without written permission from the copyright owner.

U.S. Government Restricted Rights

This computer software and related documentation are provided with Restricted Rights. Use,
duplication or disclosure by the Government is subject to restrictions as set forth in the
governing Rights in Technical Data and Computer Software clause of

DFARS 252.227-7015 (June 1995) and DFARS 227.7202-3(b).

Manufacturer is Vector Software, Inc. East Greenwich RI 02818, USA.

Vector Software reserves the right to make changes in specifications and other information
contained in this document without prior notice. Contact Vector Software to determine whether
such changes have been made.  

Third-Party copyright notices are contained in the file: 3rdPartyLicenses.txt, located in the

VectorCAST installation directory.

2
Table of Contents
INTRODUCTION 5

VectorCAST Overview 6
Starting VectorCAST 6
VectorCAST Interface 7
Using the VectorCAST Examples 9

CREATE A UNIT TESTING ENVIRONMENT 11

Create a Unit Testing Environment 12

View Source Code 12
Run the Tests 13
View the Test Results 14
Open Code Coverage Viewer 16

CREATE A SYSTEM TESTING ENVIRONMENT 18

Create a System Testing Environment 19

View System Test Script 19
Build Instrumented Executable 21
Execute Test Cases 22

CREATE AN ENTERPRISE TESTING PROJECT 23

Create an Enterprise Testing Project 24

Execute All Tests 25
View Manage Summary 26
View Code Coverage Summary 27
View File Based Coverage 29

PUBLISH PROJECT METRICS 31

VectorCAST/Analytics Project Metrics 32

Open the Analytics Dashboard 32
Understanding the Analytics Dashboard 33
Close the Analytics Server 40

3
INDEX 41

4
Introduction
 VECTORCAST OVERVIEW 6

VectorCAST Overview
VectorCAST® is a suite of test automation tools:

l VectorCAST/C++™ and VectorCAST/Ada™ automate the unit and integration testing of C, C++,
and Ada code, allowing you to easily test any subset of files (or packages for Ada) in isolation from
the rest of the application.
l VectorCAST/QA™ automates the system testing of any application, and includes code coverage
analysis for C, C++, and Ada source code.
l VectorCAST/Manage is a test automation platform that allows your team to collaborate on testing.
It provides a single point of control for test creation, execution, and reporting.
l VectorCAST/Analytics collects source code and test metrics and publishes that data via a web-
based dashboard, enabling you to identify trends in a single codebase or compare metrics between
multiple codebases.

Before you begin:

This Quick Start Guide is intended to get you started quickly with the basic features of VectorCAST. Use
it for quick reference.

For more detailed information about VectorCAST product features, please refer to the Interactive
Tutorials and to the User Guides for VectorCAST/C++, VectorCAST/Ada, VectorCAST/Manage and
VectorCAST/QA.

Starting VectorCAST
Before you start: Ensure that VectorCAST is installed and that the environment variable
VECTORCAST_DIR is set to the installation directory. Refer to the Interactive Tutorials for detailed
installation instructions.

UNIX
In UNIX or Cygwin, start VectorCAST by entering:

$VECTORCAST_DIR/vcastqt

Windows

In Windows, from the Windows Start menu, select => All Programs => VectorCAST =>
VectorCAST.
 VECTORCAST INTERFACE 7

VectorCAST Interface

Below we discuss the default controls of the VectorCAST GUI. Note that you can return to this
default arrangement at any time by using: View =>Default Layout from the menu bar.

The VectorCAST main window is divided into four panes:

l The Project Tree is located on the left-hand side of the main window. It provides a high level view
of the project structure.
l The Message Window is located along the bottom left of the main window. It contains tabs for
informational messages and for error messages.
l The Multiple Document Interface (MDI) Window is located to the right of the Project Tree. It
displays a variety of windows, including Test Case editors, Coverage Viewers, Report Viewers and
Text Editors. Windows are collected into groups. See the VectorCAST User Guide for more
information on MDI Window Groups.
 VECTORCAST INTERFACE 8

l The Jobs Monitor is located on the bottom of the main window. It displays the status of jobs as
they execute and exposes the associated back-end commands. See the VectorCAST User Guide for
more information on the Jobs Monitor.

The Project Tree and the Message Window are docking windows and can be moved to any location on
your desktop. See the VectorCAST User Guide for more information on docking windows.

The Jobs Monitor is hidden by default when VectorCAST is first opened. Hover over the Jobs tab to
open the Jobs Monitor window and move the mouse away from the tab to close the window. To keep the
window open, click the Pin icon to the right of the Jobs tab.

The Status Bar on the lower right will display the path to the working directory, the status of the
environment, and the type of Coverage initialized.

The VectorCAST tools and functions are available from the Menu Bar and the Toolbar located at the
top of the main window. The toolbar includes icons for third-party tools integrated with VectorCAST and
are functional only if you are licensed for those features. You can become familiar with the most widely
used of these tools and functions by using the Interactive Tutorials.
 USING THE VECTORCAST EXAMPLES 9

Using the VectorCAST Examples

VectorCAST has a variety of built-in examples to help you quickly learn how to use the tools.

The examples are accessed via the VectorCAST Examples page in the "Getting Started" MDI window
that appears when you start the product. To navigate to the Examples Welcome page from anywhere
within VectorCAST, select Help =>Welcome from the Menu Bar.

The VectorCAST Examples page containing links to all the examples is displayed:
 USING THE VECTORCAST EXAMPLES 10

In the remainder of this guide, you will do the following:

1. Create a VectorCAST/C++ unit test environment and run some tests.

2. Create a VectorCAST/QA system test environment and capture code coverage.
3. Create a VectorCAST/Manage project for testing collaboration.
4. Launch the VectorCAST/Analytics dashboard.
Create a Unit Testing Environment
 CREATE A UNIT TESTING ENVIRONMENT 12

Create a Unit Testing Environment

VectorCAST/C++ is a structural testing tool that allows you to easily perform Application Programming
Interface (API) testing for portions of an application in isolation from the complete application.

The VectorCAST Testing Examples provide source code and test scripts to allow you to quickly learn the
features of VectorCAST/C++.

To create a Testing Environment, navigate to the VectorCAST Examples Welcome page and under the
C Examples column, select Tutorial for C. Alternatively, from the Menu Bar you can select Help
=>Example Environments =>C=>Tutorial for C. VectorCAST will automatically build the test
environment.

Note: For the purposes of this Quick Start Guide, the discussion will be based on the Tutorial for C
example. To create a C++ or an Ada Testing Environment, select Tutorial for C++ or Tutorial for
Ada from the Example Environments menu. The menu flow and concepts discussed will be the same
for all three programming languages.

Once the environment completes building, a summary page is provided for you in the MDI Window.
Refer to this page to learn more about basic test case construction concepts, and use the provided
hyperlinks on the right to interact with your test environment.

Next, you will view the source code.

View Source Code

To view the source code for this example, right-click on the name of the Unit Under Test (UUT) located
in the Project Tree and select Open Source.
 RUN THE TESTS 13

The Text Editor opens up in the MDI Window and you will see the source code for the selected file
displayed. The initial code display is read-only. To edit the source code, check the Writable box in the
lower right. Right-click with your mouse within the MDI Window to view a pop-up menu of editing
commands.

Run the Tests

The example environment has some pre-built test cases. To run a single test case, right-click on PLACE_
ORDER.001 in the Project Tree and select Execute. You can also execute the test case by selecting the
Execute button from the Toolbar.
 VIEW THE TEST RESULTS 14

Note that after the test has executed the Project Tree updates to display the test case status. Passing test
cases are displayed in green. Failing test cases are displayed in red. Hover over the test case to see the
execution time and the percentage of expected values reached.

A new column is displayed in the Project Tree indicating statement coverage status. Hover over the status
bar to see that running test case PLACE_ORDER.001 achieves 58% statement code coverage for the
subprogram Place_Order, covering 10 out of 17 statements.

View the Test Results

View the test results for the test case by highlighting the test case in the Project Tree and selecting Test
=>View =>Execution Results from the Menu Bar.

The Execution Results Report is displayed in the Report Viewer. The Report includes the configuration
of the test case, the execution results with the expected and actual values, and the test status. Refer to
your VectorCAST User Guide for more information on viewing test execution results.
 VIEW THE TEST RESULTS 15

Depending on the items selected in the Project Tree, you can view the Execution Results for a single test
case, a combination of test cases, a subprogram or an environment by selecting Test =>View
=>Execution Results and viewing the Execution Results Report.

The Test Case Management Report is a summary of the testing status for a particular environment. First,
execute all the Test Cases. Right click on the Project Name in the Project Tree and select Execute or
select the Execute button from the Toolbar.

As the Test Cases execute you will see the Execution Status Monitor window open, allowing you to see
the output and status of each test as it is running in real time. Refer to your VectorCAST User Guide to
learn more about the Execution Status Monitor and Jobs Monitor windows.

Once the Test Cases have executed, you can view the Test Case Management Report by selecting Test
=>View =>Test Case Management Report from the Menu Bar.

The contents of the report reflect the items selected in the Project Tree. Scroll through the report and note
the information provided.
 OPEN CODE COVERAGE VIEWER 16

Open Code Coverage Viewer

Open the Code Coverage Viewer by selecting the View Coverage button from the Tool Bar. You can
also access the Code Coverage Viewer by right-clicking on the name of the Unit Under Test in the
Project Tree and selecting View Coverage.

An annotated version of the manager source code is displayed in the Coverage Viewer in the
 OPEN CODE COVERAGE VIEWER 17

MDI Window. For display purposes here the example environment has been assigned Basis Paths
coverage type.
Create a System Testing
Environment
 CREATE A SYSTEM TESTING ENVIRONMENT 19

Create a System Testing Environment

VectorCAST/QA is the integration of VectorCAST/Cover and VectorCAST/Manage. It automates the
system testing of any application, and includes code coverage analysis for C, C++, and Ada source code.
Code coverage analysis is the best way to measure the completeness of testing, and VectorCAST/QA
makes this simple, regardless of your testing methodology.

To build the VectorCAST/QA example, navigate to the VectorCAST Examples Welcome page and under
the VectorCAST/QA column, select QA Demo. Alternatively, from the Menu Bar you can select Help
=>Example Environments =>QA =>QA Demo. VectorCAST will automatically build the QA Project.

In the Project Tree, note that the qa_demo project is displayed. Expand the nodes to show the cover_
demo environment. There are also three columns on the right to display coverage status for Statement,
Branch and MC/DC Pairs. Use your mouse to hover over the coverage bar for the qa_demo project and
observe that it has 55% Statement coverage.

Next, you will view the Python Configuration Script, system_tests.py.

View System Test Script

The Python Configuration Script contains functions that are invoked by VectorCAST/Manage to provide
custom build and execute commands based on the name of a VectorCAST/Cover environment in a
VectorCAST/Manage project. The configuration script is fully customizable and allows the user to define
the application build commands, list of test cases, and test execution commands for an application.

To open and edit the Configuration Script, right-click on the cover_demo Environment node and select
System Testing => Edit Script from the context menu.
 VIEW SYSTEM TEST SCRIPT 20

The Python Configuration Script opens in the Script Editor.

Note that the script contains the build command for the application. Also note the list of 6 system test
cases: Place_Order, Get_Check_Total, ClearTable, AddIncludedDessert, NextParty, and the
manual test case InitializeWB.

The script can be modified as required and the changes saved. We will use the existing script for our
example and simply close the text editor.

Next, you will build the instrumented executable using the system_tests.py script.
 BUILD INSTRUMENTED EXECUTABLE 21

Build Instrumented Executable

To build the instrumented executable, right-click on the cover_demo environment node and select Build
from the context menu. Once the Python configuration has been set up, the incremental build
functionality performs only the work that needs to be done, based on the current state of the project.

The Build Status column in the Project Tree now shows green check marks indicating successful build
status. Hover over the check marks to see popups with the build details.

The Manage Incremental Rebuild Report opens when the build is complete. Note that we made no
modifications to files or test cases, and the report shows a successful rebuild with no files, functions or
test cases affected.
 EXECUTE TEST CASES 22

Also note that there are a total of 4 tests reported. Recall that we noted 6 tests are listed in the Python
Configuration Script. Two of the tests are missing here.

Next, we will run the missing test cases in the cover_demo environment.

Execute Test Cases

To run the test cases in the cover_demo environment, right-click on the environment in the Project Tree
and select Execute => Full from the context menu. Once again, the incremental build and execute
functionality performs only the work that needs to be done based on the current state of the project.

In our example, only the two missing tests cases, NextParty and InitializeWB, were executed.

To learn more about System Testing environments, see the "VectorCAST/QA - System Test Automation"
section in the VectorCAST/Manage User Guide.
Create an Enterprise Testing Project
 CREATE AN ENTERPRISE TESTING PROJECT 24

Create an Enterprise Testing Project

VectorCAST/Manage is a Test Automation Framework that sits on top of VectorCAST/C++ or
VectorCAST/Ada test environments and allows test design, execution, and reporting to be distributed
across the enterprise. The Manage project supports a variety of work flows allowing for team
collaboration, testing of multiple configurations, change-based testing, and massively parallel testing.

VectorCAST/Manage can import existing VectorCAST/C++ and VectorCAST/Ada test environments, or

be used to create new environments. In this section, you will take existing VectorCAST environments
and import them into a Manage Project.

Before you start: The basic Manage example is built using any Unit Testing Environments you
created previously. If there are no existing environments, the Manage example will create a new unit
test environment using the Tutorial for C.

For our example, we will be importing the C, C++, C++ BlackBox, C++ Whitebox and Ada example
environments.

To set up for the Manage project, go to the VectorCAST Examples Welcome page and if the Tutorial for
C under the C Examples column does not have a green check mark displayed next to it, click to run the
example. Return to the VectorCAST Examples Welcome page and continue to click on each of the
following examples until each displays a green check mark: Tutorial for Ada, Tutorial for C++, Basic
Class (BlackBox), and Basic Class (Whitebox).

To create a Manage project, navigate to the VectorCAST Examples Welcome page and under the
VectorCAST/Manage column, select Manage Demo. Alternatively, from the Menu Bar you can select
Help =>Example Environments =>Manage =>Manage Demo. VectorCAST will automatically build
 EXECUTE ALL TESTS 25

the Manage Project using the Unit Testing environments you created previously.

Once the project completes building, a VectorCAST/Manage Example summary page is provided for you
in the MDI Window. Refer to this page to learn more about basic Manage project concepts, and use the
provided hyperlinks on the right to interact with your project.

In the Project Tree you will now see the manage_demo project displayed. Note that a Test Suite has been
created which contains each of the environments. Expand the Project Tree to see the individual
Environments.

Next, you will execute all of the tests.

Execute All Tests

To execute all of the tests in the manage_demo project, right-click on the Project Name (manage_demo)
and select Execute from the context menu. You can follow the execute process in the Messages pane.

As test cases are executed data is stored in a SQL database and used to generate reports showing testing
status and trends, making it easy to analyze regression trends.

The Status Panel updates to display testing status. On the status panel you will see status for the
Environment Build, Test Execution and Statement Coverage. Hover over the Statement Coverage bar to
 VIEW MANAGE SUMMARY 26

see a pop-up of the Build and Coverage details.

View Manage Summary

The Manage Summary table allows you to easily view environment execution results and metrics for all
the environments of a Manage project. To open the summary from the Toolbar, select the manage_demo
node in the Project Tree and then select Manage Summary from the Data Summary Report icon drop-
down menu.

Alternatively, from the Menu Bar, select Project => Manage Summary.

The Manage Summary opens and displays data for all five environments in our manage_demo project.
 VIEW CODE COVERAGE SUMMARY 27

The Manage Summary is dynamic and tracks the current selection in the Project Tree. Try selecting
different environment nodes and note that as units are selected and deselected in the Project Tree, the
Manage Summary table updates in real time reflecting the selections.

The data displayed in the Manage Data Summary includes the Environment name, Build Status, Build
Time, number of Test Cases, number of Expected Values, Execution Time and achieved coverage for each
coverage type.

The Totals row at the top of the table displays the totals for each data column. In the example above,
note that in the manage_demo project we have a total of 10 test cases, covering 50 statements.

Sorting and filtering is available to locate data of interest. Sort by clicking on any column heading.
Access the filter by typing into the top row of any column.

See the VectorCAST/Manage User Guide for more detailed information on the Manage Summary table.

View Code Coverage Summary

The Code Coverage Summary table allows you to easily view coverage information for all the
environments of a Manage project. To open the summary from the Toolbar, select Code Coverage
 VIEW CODE COVERAGE SUMMARY 28

Summary => Code Coverage Summary from the Data Summary Report icon drop-down menu.

Alternatively, from the Menu Bar, select Coverage => Code Coverage Summary => Code Coverage
Summary.

On initial open, the Code Coverage Summary table displays coverage data for all environments in the
Manage project. By default, the contents of the Code Coverage Summary reflect the source files selected
in the Files tab. Use the Files tab to select data of interest to be displayed in the summary. In our
example, we have selected the manager.cpp source file in the Files tab. A tracking icon is displayed
at the top of the Unit column indicating that the Code Coverage Summary is currently tracking selected
source files.

The Code Coverage Summary table is dynamic. When the Track Current Selection option is enabled, as
units are selected and deselected in the Files tab, the Code Coverage Summary table updates in real time
reflecting the selections. Try selecting different source files and note that as files are selected and
deselected in the Files tab, the Code Coverage Summary updates in real time reflecting the selections.

To override tracking of selected source files, open the drop-down menu for the Data Summary Report and
select Options => Track Current Selection. Remove the check next to the option. The tracking icon on
the Summary table will change to gray to indicate that the summary is now tracking all units in the
Files tab.

The data displayed in the Code Coverage Summary includes the Unit name, Subprogram name,
Cyclomatic Complexity (Vg), and the achieved coverage for each coverage type.

The Totals row at the top of the table displays the totals for each data column. In the example above,
note that in the unit manager.cpp we have a total of 41 statements, of which 16 statements are covered
and 25 are uncovered.

The Summary table updates whenever coverage data is updated. For example, the table refreshes when
 VIEW FILE BASED COVERAGE 29

coverage is initialized, or following test execution.

Sorting and filtering is available to locate data of interest. Sort by clicking on any column heading.
Access the filter by typing into the top row of any column.

See the VectorCAST/Manage User Guide for more detailed information on the Code Coverage Summary
table.

View File Based Coverage

To view the File Based Coverage Results, select the Files tab in the Project Tree. Right-click on the
filename and select View =>Coverage Viewer.

The coverage results for the selected file will open in the MDI Window. Scroll through the results for the
selected file. Note the bar in the upper right indicating that manager.c has 26% Statement coverage.
 VIEW FILE BASED COVERAGE 30

For a quick view of the details of a specific file hover over the filename listed in the Files pane of the
Project Tree. The at-a-glance information includes the full path for the file, date and time of the
modification at the last build, an aggregate of statement coverage and a list of which environments use
the file.

To learn more about using Enterprise Testing Projects in your organization, refer to the
VectorCAST/Manage User Guide. There you will find examples of common work flow scenarios and in-
depth discussion of features and functionality.
Publish Project Metrics
 VECTORCAST/ANALYTICS PROJECT METRICS 32

VectorCAST/Analytics Project Metrics

VectorCAST/Analytics provides a web-based dashboard view of software code quality and testing
completeness metrics, making it easy to understand the current state of quality and testing completeness
for a software project. This critical intelligence allows all stakeholders to make decisions about release
readiness and process improvement.

Open the Analytics Dashboard

To open the Analytics Dashboard, click the Start Analytics icon located on the Toolbar. This will
automatically create a Manage project for the environments in the current working directory using the
Automation Controller scripts.

Once the Start Analytics icon is selected, the Analytics Controller opens in the MDI window. The
Automation Controller Output pane, displayed at the top of the Analytics Controller, shows the output of
the Automation Controller scripts.

At the completion of the Automation Controller scripts, the vcdash command is invoked and the
Analytics Server is launched. The Analytics Server Output pane, displayed at the bottom of the Analytics
Controller, shows the status of the launch.

At the bottom of the Analytics Controller, a Start Server/Stop Server button is available. A Start
 UNDERSTANDING THE ANALYTICS DASHBOARD 33

Server/Stop Server option is also available from the Start Analytics drop-down menu on the Toolbar.
Clicking the Start Server button starts the Analytics Server on an available port and opens the Analytics
Dashboard in a browser window.

Clicking the Stop Server button shuts down the Analytics Server and the Analytics Dashboard remains
open in the browser. A message "Cannot reach server" is displayed on the Dashboard to alert the user that
the connection to the server has been terminated.

If the Analytics Server is running, and the Analytics Dashboard is not currently open in a browser,
selecting the Open Dashboard button from the bottom of the Analytics Controller or selecting the Open
Dashboard option from the Start Analytics drop-down menu opens the Analytics Dashboard in a
browser window. The button is only available if the Analytics Server has been launched.

Once the server has started, VectorCAST automatically opens a browser window displaying the Analytics
Dashboard for the open project.

Understanding the Analytics Dashboard

For the purposes of our discussion, we have selected to view the metrics for the source file c/manager.c
by clicking on the link in the Project Source Code Tree.

The Analytics Dashboard is composed of three main areas:

l Project-wide Metrics
l Project Source Code Tree
 UNDERSTANDING THE ANALYTICS DASHBOARD 34

l Metrics for selected source file(s)

Project-wide Metrics
Key project-wide Metrics are displayed in the top bar of the dashboard, providing an at-a-glance view of
the size, complexity and testing completeness of the project. Metrics include:

l Functions - total number of functions in the project

l Statements - total number of statements in the project
l Statement Coverage - percentage of statements covered in the project
l Avg. Complexity/Function - the average code complexity, or V(g), per function
l Static Analysis Issues - total number of static analysis issues in the project
l Comment Density - the percentage of comments to effective lines of code

The Project-wide Metrics are functional buttons which control the sorting and display of the project's
Source Code Tree. In our example, the Statements button is selected, and the source code files are listed
in the Tree showing those having the greatest number of covered statements at the top.
 UNDERSTANDING THE ANALYTICS DASHBOARD 35

Source Code Tree

The Source Code Tree lists the source files and functions associated with the project. The selections made
in the Source Code Tree control the granularity of the metrics displayed in the dashboard. Metrics can be
displayed for the entire project, or all the way down to metrics for an individual file. The presentation of
the Tree is controlled by the selected Metrics button.

The data displayed in the right column of the Source Code Tree is associated with the selected Metrics
button. Try selecting the Statement Coverage button, and note that the right column then shows the
percentage of statement coverage achieved, listed from lowest to highest percentage.

Note that the Source Code Tree uses an icon beside a file name and an icon beside a function
name. Clicking on a file name icon will open the file's source code in a Viewer. Clicking on a function
name icon will open the file's source code in a Viewer and will jump to the function's location in the
code.

Metrics Display
Metrics are displayed in the right of the browser for the file or files selected in the Source Code Tree. In
our example, we have selected the single file manager.c, and the dashboard displays the metrics
associated with that file.

The top three boxes provide the Metrics, Testing, and Static Analysis data for the selected file,
manager.c.
 UNDERSTANDING THE ANALYTICS DASHBOARD 36

Below the boxes two heat maps are displayed for the file manager.c, one for Statements vs. Coverage
and one for Complexity vs. Coverage. Each function maps to a box in the heat map. Hovering over a box
displays the underlying data.

The size of the boxes within the heat maps reflects the number of statements or level of complexity of the
functions. Functions with a large number of statements or high complexity will be larger in size.
 UNDERSTANDING THE ANALYTICS DASHBOARD 37

The color of the boxes within the heat map indicates the level of coverage of the functions.

l Green indicates a high level of coverage.

l Red indicates a low level of coverage.
l Gradient shades reflect partial coverage, with less coverage and higher risk as the values approach
red.

Using the example above, we can easily identify that the function Add_Party_To_Waiting_List is a hot
spot which is highly complex and poorly tested. This information is critical in deciding how to best
allocate testing and refactoring resources on a project.

Tabular data is located by scrolling down the browser window. A set of four tables is provided showing
the Highest Complexity listed by file and by function, and the Least Coverage listed by file and by
 UNDERSTANDING THE ANALYTICS DASHBOARD 38

function for the selected files. In this example, we have selected to view the metrics for the manager.c
unit. Note that the name of the source file is provided in parentheses to the right of the function name.

Source Code Viewer

Clicking on any of the listed source file names or the icon in either the Source Code Tree or the
Metrics Tables will open the source code in a viewer. Clicking on the icon of a listed function will
open the source file and scroll to the function. Use the button in the Title Bar to close the viewer.

Coverage Viewer
Select one of the following buttons from the upper right of the Source Code Viewer's Title Bar to view
coverage for the source file:

- Opens the Coverage Viewer. This button is only available when the selected
file has covered branches, pairs or statements.
- Opens Lint Static Analysis results. This button is only available when the
selected file has Lint Static Analysis results.
 UNDERSTANDING THE ANALYTICS DASHBOARD 39

- Opens Klocwork Analysis results. This button is only available when the
selected file has Klockwork Analysis results.
- Closes the Viewer and returns to the Analytics dashboard.

The Coverage Viewer provides an annotated version of the source file, colorized to indicate the coverage
level achieved. Green highlighted code indicates the line is covered. Red highlighted code indicates the
line is not covered. Yellow highlighted code indicates partial coverage for the line. In the example
below, the file manager.c shows Statement coverage:

Icons in the column on the left give additional information regarding coverage. Hover over an icon for
more information. The following icons (in combination with the red, green and yellow line highlighting)
 are used to annotate the coverage level:

For Statement coverage:

- Statement covered

- Statement not covered

For Branch coverage:

- True covered (No false branch)

- True and False covered

- True covered, False not covered

- True not covered, False covered

- Neither True nor False covered

For Merged coverage data:

- All covered
- Not covered
- Partial coverage
 CLOSE THE ANALYTICS SERVER 40

Close the Analytics Server

To close the Analytics Server, select Start Analytics => Stop Server from the Toolbar. Alternatively,
select the Stop Server button located at the bottom of the Analytics Monitor.
 Index: ACCESSING EXAMPLES – VIEW TEST RESULTS

Index project tree 25

location of 7
accessing examples 9
python configuration script 19
analytics
reports
analytics monitor 32
execution results report 14
coverage viewer 38
test case management report 15
heat maps 36
run test cases 13
launch analytics server 32
sort/filter
metrics display 35
code coverage summary 29
project-wide metrics 34
manage summary 27
source code tree 35
source code
understanding the dashboard 33
edit 13
view source code 38
view 12
build instrumented executable 21
starting VectorCAST 6
code coverage 16
status panel 25
code coverage summary 27
system testing environment 19
track current selection 28
Test case management report 15
coverage viewer 16
test suite 25
create system testing environment 19
toolbar 8
create unit testing environment 12
unit testing environment 12
edit source code 13
VectorCAST
enterprise testing 24
examples 9
environment groups 25
starting 6
execute 22
VectorCAST interface
execute command 13
jobs monitor 7
execution results report 14
MDI window 7
execution status monitor 15
message window 7
incremental rebuild 21
project tree 7
incremental rebuild report 21-22
toolbar 8
jobs monitor 7
view source code 12
manage
view system test script 19
build/execute 25
view test results 14
create a project 24
file based coverage 29
manage summary 26
MDI window 7
message window 7

- 41 -