Logiscope TestChecker Help Index

How To ...

produce code coverage result files

create a test suite

create and run a test

rename a file or a test

move a test

insert a test suite into a project

remove a test suite from the project

Commands

File menu

Edit menu

View menu

Build menu

Window menu

Help menu


File menu commands

The File menu offers the following commands:

New	Creates a new file.
Open	Opens an existing file.
Close	Closes an opened file.
Open Project	Opens the current project.
Save Project	Saves the current project.
Close Project	Closes the current project.
Save	Saves an opened test suite using the same file name.
Save As	Saves an opened test suite to a specified file name.
Save All	Saves all open documents and test suites.
Print	Prints the content of the active window.
Print Preview	Displays the content of the  window on the screen as it would appear printed.
Print Setup	Selects a printer and printer connection.
Recent Files 1, 2, 3, 4	Opens one of the four most recently used documents.
Recent Projects 1, 2, 3, 4	Opens one of the four most recently used projects.
Exit	Exits TestChecker.


Edit menu commands

The Edit menu offers the following commands:

Cut	Deletes the select test and moves it to the clipboard.
Copy	Copies the selected test to the clipboard.
Paste	Pastes the previously cut or copied test from the clipboard into the document.
Delete	Deletes the selected information.
New Test	Creates a new test.
Reset Test	Resets the selected test.
Report	Generates a report.


View menu commands

The View menu offers the following commands:

DDP Spy	Shows or hides the DDP Spy.
MCDC Spy	Shows or hides the MCDC Spy.
DDP Coverage	Shows or hides the DDP list.
MC/DC	Shows or hides the Modified Condition/Decision Coverage window
Source Code	Shows or hides the source code.
Component	Shows or hides the component window.
Test	Shows or hides the test window.
Project	Shows or hides the project window.
Status Bar	Shows or hides the status bar.
Toolbar	Shows or hides the toolbar.
Messages	Shows or hides the messages window.
Refresh	Refreshes the test results.
Properties...	Displays the properties of the selected project item.


Build menu commands

The Build menu offers the following commands, which enable you to build and manage tests:

Build	Builds the instrumented executable file to be tested.
Go	Starts a new test.
Settings...	Allows to specify the test parameters.


Window menu command
Window menu commands

The Window menu offers the following commands, which enable you to arrange multiple views of multiple documents in the application window:

New Window	Creates a new window that views the same document.
Close all	Closes all result windows.
Cascade	Arranges windows in an overlapped fashion.
Tile	Arranges windows in non-overlapped tiles.
Arrange Icons	Arranges icons of closed windows.
Update with selection	Keeps the active window updated with the information selected.
Window 1, 2, ...	Goes to specified window.


Help menu commands

The Help menu offers the following commands, which provide you assistance with this application:

Help Topics	Offers you an index to topics on which you can get help.
About	Displays the version number of this application.
Logiscope Support Web Site	Displays the Kalimetrix Support Web Site.


File New command
New command (File menu)

Use this command to create a new test suite in TestChecker.

You can open an existing file with the Open command.

Shortcuts

Toolbar:

Keys:	CTRL+N


File Open command
Open command (File menu)

Use this command to open an existing test suite. You can open multiple files at once. Use the Window menu to switch among the multiple open files. See Window 1, 2, ... command.

Use also this command to import instrumented application traces (*.trc). These traces are produced when the application is linked with a specific library or when the environment variable VLGTYP is set to TRACKS with VlgTc.lib.

You can create new documents with the New command.

Shortcuts

Toolbar:

Keys:	CTRL+O


File Open dialog box

The following options allow you to specify which file to open:

Look in

Select the drive and directory in which TestChecker stores the file that you want to open.

File Name

Type or select the filename you want to open. This box lists files with the extension you select in the List Files of Type box.

Files of Type

Select the type of file you want to open.


File Close command
Close command (File menu)

Use this command to close all windows containing the active document. The information related to the document displayed in the window is retained in memory and remains part of the project until you close it with the Close Project command.


File Save command
Save command (File menu)

Use this command to save the active test suite to its current name and directory. When you save a test suite for the first time, TestChecker displays the Save As dialog box so you can name your suite. If you want to change the name and directory of an existing suite before you save it, choose the Save As command.

Shortcuts

Toolbar:

Keys:	CTRL+S


File Save As command
Save As command (File menu)

Use this command to save and name the active test suite. TestChecker displays the Save As dialog box so you can name your test suite.

To save a test suite with its existing name and directory, use the Save command.


Save All command (File menu)

Use this command to save all of the test suites and documents included in the project . When you save a test suite or project document for the first time, TestChecker displays the Save As dialog box so you can name it.


File Save As dialog box

The following options allow you to specify the name and location of the file you're about to save:

Save in

Select the directory and drive in which you want to store the document.

File Name

Type a new filename to save a document with a different name. TestChecker adds the extension you specify in the Save As Type box.


Recent Files 1, 2, 3, 4 command (File menu)

Use the numbers and filenames listed at the bottom of the File menu to open the last four documents you closed. Choose the number that corresponds to the document you want to open.


Recent Projects 1, 2, 3, 4 command (File menu)

Use the numbers and filenames listed at the bottom of the File menu to open the last four projects you closed. Choose the number that corresponds to the document you want to open.


Exit command (File menu)

Use this command to end your TestChecker session.  You can also use the Close command on the application Control menu.  TestChecker prompts you to save documents with unsaved changes.

Shortcuts

Mouse:	Double-click the application's Control menu button.

Keys:	ALT+F4


Cut command (Edit menu)

Use this command to remove the currently selected test and put it on the clipboard. This command is unavailable if there is no data currently selected.

Cutting data to the clipboard replaces the contents previously stored there.

Shortcuts

Toolbar:

Keys:	CTRL+X


Copy command (Edit menu)

Use this command to copy the currently selected test onto the clipboard. This command is unavailable if there is no data currently selected.

Copying data to the clipboard replaces the contents previously stored there.

Shortcuts

Toolbar:

Keys:	CTRL+C


Paste command (Edit menu)

Use this command to insert a copy of the tests contained in the clipboard into the active document. This command is unavailable if the clipboard is empty.

Shortcuts

Toolbar:

Keys:	CTRL+V


Delete command (Edit menu)

Use this command to delete the selected tests or remove the selected files from the current application. This command is unavailable if there is no data currently selected.

Shortcuts

Toolbar:

Keys:	DELETE


New Test command (Edit menu)

Use this command to create a new test in active the test suite. The active test suite is either the suite displayed in the active window, or the suite selected in the project window.

Shortcuts

Toolbar:


Reset Test command (Edit menu)

Use this command to clear all DDP execution and coverage information obtained through the execution of the active test. This command resets the results to zero. The active test is either the test displayed in the active window, or the test selected in the project window.


Report command (Edit menu)

Use this command to generate a report in a file. TestChecker displays the Generate Report dialog box so you can choose a format and give a name to the report.


DDP Spy command (View menu)

Use this command to display and hide the DDP Spy window , which shows test progress indicators. A check mark appears next to the menu item when the DDP Spy window is displayed


DDP Spy window

This window shows test coverage progress during test execution. The progress indicators it contains are:

§	Global

Shows the coverage rate achieved by all the tests.

§	Current

Shows the coverage rate achieved by the current test.

§	Improvement

Shows the overall coverage rate improvement achieved by the current test.


MCDC Spy command (View menu)

0	Use this command to display and hide the MCDC Spy window , which shows test progress indicators. A check mark appears next to the menu item when the MCDC Spy window is displayed


MCDC Spy window

0	This window shows test coverage progress during test execution. The progress indicators it contains are:

§	Global

Shows the coverage rate achieved by all the tests.

§	Current

Shows the coverage rate achieved by the current test.

§	Improvement

Shows the overall coverage rate improvement achieved by the current test.


DDP Coverage command (View menu)

0	Use this command to display and hide a window with the list of DDPs for the selected component. A check mark appears next to the menu item when the DDP Coverage window is displayed


MC/DC command (View menu)

0	Use this command to display and hide the Modified Conditions/Decisions Coverage window


DDP Coverage window

0	This window lists the Decision-to-Decision Paths (DDPs) contained in the current component,

1	The DDP coverage window provides the following information::

Tested	Indicates covered DDPs.
Line	Indicates the source code line for the DDP.
# of DDP	Indicates the number of the DDP.
DDP	Provides a description of the DDP.

11	Untested DDPs are displayed in red characters.

12	You can sort this information by increasing or decreasing line number or DDP number,

13	by clicking respectively on the "Line" or "# of DDP" columns.

14	You can access the source code for each of the DDPs. To do so:

15	Select the View - Source Code command

16	Click a DDP: the corresponding code is highlighted in the Source Code window


Source Code command (View menu)

0	Use this command to display and hide the source code for the selected component. The content of the window cannot be modified. A check mark appears next to the menu item when the source code window is displayed


Source code window

0	This window allows you to view and modify the source code of the component or source file selected in the project or component window. You can use the standard edition commands to search for code, cut, paste and save updated source files.


Component window

0	This window allows you to view the components of your application, along with the test coverage rate achieved.

1	By default, components are listed in alphabetical order.

2	You can click on a column heading to sort results by component name or by coverage: click on a column heading once to sort results by increasing order and another time to switch to decreasing order.

3	The information displayed in component windows differs according to the item you select in the project window

§	When you double-click the application identifier located at the top of the project window tree (the Components tab must be in the foreground), a component window appears and displays the components of your application and the coverage rate achieved for each of them.

§	When you double-click the identifier of a source file, a component window appears and displays the names of the components it contains, as well as the corresponding test coverage figures.

§	When you double-click the identifier of a test (the Tests tab must be in the foreground), a component window appears and displays the list of components tested and the coverage obtained.

0	You can use the print command to print the information displayed in component windows.

1	Tip


Recycling windows

Once you have open a component or test  window, click the [image] (recycle) button located in its lower left-hand corner. The recycle feature allows you to save screen space by viewing your coverage results in one window only.

From now on, click only once on the item for which you want coverage rate figures: the component window is automatically updated with the appropriate information.


Test window

0	This window allows you to view the tests which have been run on your application, along with the test coverage rates and the improvement achieved.

1	Also displayed is the status code returned by the tested software.

2	By default, tests are listed in alphabetical order.

3	You can click on a column heading to sort results by test name or by coverage: click on a column heading once to sort results by increasing order and another time to switch to decreasing order.

4	The information displayed in test windows differs according to the item you select in the project window

§	When you double-click the application identifier located at the top of the project window tree (the Tests tab must be in the foreground), a component window appears and displays:

•	all the tests which have been carried out,

•	the overall coverage rate achieved after running each test,

•	the coverage improvement obtained by each of the tests.

§	When you double-click the identifier of a test suite (.dyn), a test window appears and displays.

•	all the tests contained in the test suite file,

•	the overall coverage rate achieved after running each test,

•	the coverage improvement obtained by each of the tests.

§	When you double-click the identifier of a component (the components tab must be in the foreground), a test window appears and displays:

•	the list of tests which have executed at least one DDP of the component selected,

•	the overall coverage rate achieved after running each test,

•	the coverage improvement obtained by each of the tests.

You can use the print command to print the information displayed in test windows.

Tip


Component command (View menu)

Use this command to display the component window and view the components for the current selection.


Test command (View menu)

Use this command to display the test window and view the tests for the current selection.


Project command (View menu)

Use this command to display and hide the project window . A check mark appears next to the menu item when the project window is displayed.


Project window

In this dockable window you can view the components of your application or the structure of the current test suite, depending on the tab selected:

§	Components

§	Tests


Messages command (View menu)

0	Use this command to display and hide the messages window . A check mark appears next to the menu item when the messages window is displayed


Messages window

§	In this window you can view the warning/error messages of your application.


Project window manipulation

You can move the project window around like any other window. To do so:

1	Click the outer area of the project window, a frame outline appears.

2	Pull away to the right to separate the project window  from the main TestChecker window.

To bring the project window back to its former location:

0	Click the title bar of the project window.

1	Drag the outline back against the left-hand edge of the TestChecker window.


Components tab

Click the component tab to see the structure of the code for your project. The levels are, from top to bottom:

§	the name of the current project ,

§	the application's source files,

§	the components which make up the source code.

0	Click the plus sign next to a level to expand it.

1	Double click a file or component identifier to display its content.


Tests tab

0	Click the test tab to see the structural outline of the tests in your project. The levels are, from top to bottom:

§	the name of the current project ,

§	the test suites contained in the project,

§	the tests in each of the suites.

0	Click the plus sign next to a level to expand it.

1	Double click a test suite or test identifier to display its content.


View Toolbar command
Toolbar command (View menu)

Use this command to display and hide the Toolbar, which includes buttons for some of the most common commands in TestChecker, such as File Open. A check mark appears next to the menu item when the Toolbar is displayed.

See Toolbar for help on using the toolbar.


Toolbar

0	The toolbar is displayed across the top of the application window, below the menu bar. The toolbar provides quick mouse access to many tools used in TestChecker,

1	To hide or display the Toolbar, choose Toolbar from the View menu.

Click	To

Open a new document.

Open an existing document.  TestChecker displays the Open dialog box, in which you can locate and open the desired file.

Save the active document or template with its current name. If you have not named the document, TestChecker displays the Save As dialog box.

Remove selected data from the document and stores it on the clipboard.

Copy the selection to the clipboard.

Insert the contents of the clipboard at the insertion point.

Delete the selected tests.

Create a new test.

Build the instrumented executable file used for testing.

Start a new test.

Expand the first level of the structure displayed in the project window.

Expand the first and second level of the structure displayed in the project window.

Expand all three levels of the structure displayed in the project window.

Refresh the coverage information displayed in the result windows during test execution.

Print the content of the active window.

Display information about TestChecker.

Display TestChecker on line help.


View Status Bar Command
Status Bar command (View menu)

Use this command to display and hide the Status Bar, which describes the action to be executed by the selected menu item or depressed toolbar button, and keyboard latch state. A check mark appears next to the menu item when the Status Bar is displayed.

See Status Bar for help on using the status bar.


Status Bar

0	The status bar is displayed at the bottom of the TestChecker window.  To display or hide the status bar, use the Status Bar command in the View menu.

1	The left area of the status bar describes actions of menu items as you use the arrow keys to navigate through menus.  This area similarly shows messages that describe the actions of toolbar buttons as you depress them, before releasing them. If after viewing the description of the toolbar button command you wish not to execute the command, then release the mouse button while the pointer is off the toolbar button.

2	The right areas of the status bar indicate which of the following keys are latched down:

Indicator	Description

CAP	The Caps Lock key is latched down.

0	NUM	The Num Lock key is latched down.

1	SCRL	The Scroll Lock key is latched down.


Refresh command (View menu)

0	Use this command to refresh the windows which contain test results.

Shortcuts

Keys:	CTRL+SHIFT+R


Properties... command (View menu)

0	Use this command to display the properties of the selected project item.

Shortcuts

Keys:	ALT+ENTER


Build command (Build menu)

0	Use this command to generate the instrumented executable file. A message indicates the completion of the creation process.

See the Settings dialog box for more help on configuring your generation parameters.

Shortcuts

0	Toolbar:

2	Keys:	F7


Go command (Build menu)

0	Use this command to start a new test. This command is available if the selected test has never been executed before. If no test is currently selected, a new one is created automatically and then executed.

1	More generally, the Go command is available when no test is currently in progress.

Shortcuts

Toolbar:

1	Keys:	F5


Settings... command (Build menu)

Use this command to display the projects settings (Test and Build ) dialog box.

Shortcuts

Keys:	ALT+F7


Settings - Build

0	Use this tab to view default TestChecker project settings.

Command

Displays the pathname of the command which builds the instrumented executable file to be tested.

Parameters

Displays parameters for the command.

Source directory

Displays the pathname of the source files needed to compile the application to be tested.


Settings - Test

0	Use this tab to view default test execution settings.

Command

Displays the pathname of the command which starts up the test.

Parameters

Displays test startup command parameters.

Working directory

Displays the pathname of the test startup command's working directory.

Use standard communication pipe

Defines the communication mode used between the tested software and TestChecker. This checkbox must be checked to communicate with TestChecker Gateway.

0	By default, the checkbox is deselected and the communication process uses named communication pipes.


New command (Window menu)

0	Use this command to open a new window with the same contents as the active window.  You can open multiple document windows to display different parts or views of a document at the same time.  If you change the contents in one window, all other windows containing the same document reflect those changes.  When you open a new window, it becomes the active window and is displayed on top of all other open windows.


Close all command (Window menu)

0	Use this command to close multiple opened windows.


Cascade command (Window menu)

Use this command to arrange multiple opened windows in an overlapped fashion.


Tile command (Window menu)

Use this command to arrange multiple opened windows in a non-overlapped fashion.


Tile Horizontal command (Window menu)

Use this command to vertically arrange multiple opened windows in a non-overlapped fashion.


Tile Vertical command (Window menu)

Use this command to arrange multiple opened windows side by side.


Arrange Icons command (Window menu)

Use this command to arrange multiple minimized windows in an orderly fashion.


Update with selection command (Window menu)

0	Use this command to view whatever results you select in the active window. A check mark appears in front of the menu item when this option is enabled.


1, 2, ... command (Window menu)

TestChecker displays a list of currently open document windows at the bottom of the Window menu. A check mark appears in front of the document name of the active window. Choose a document from this list to make its window active.


Search command (Help menu)


Index command (Help menu)

Use this command to display the opening screen of Help.  From the opening screen, you can jump to step-by-step instructions for using TestChecker and reference information.

Once you open Help, you can click the Contents button whenever you want to return to the opening screen.


Using Help command (Help menu)

Use this command for instructions about using Help.


About command (Help menu)

Use this command to display the copyright notice and version number of your copy of TestChecker.


Help Using Help Command
Context Help command

0	Use the Context Help command to obtain help on some portion of TestChecker. When you choose the Toolbar's Context Help button, the mouse pointer will change to an arrow and question mark.  Then click somewhere in the TestChecker window, such as another Toolbar button.  The Help topic will be shown for the item you clicked.

Shortcut

Keys:	SHIFT+F1


Title bar

The title bar is located along the top of a window.  It contains the name of the application and document.

To move the window, drag the title bar.  Note: You can also move dialog boxes by dragging their title bars.

A title bar may contain the following elements:

§	Application Control-menu button

§	Document Control-menu button

§	Maximize button

§	Minimize button

§	Name of the application

§	Name of the document

§	Restore button


Scroll bars

Displayed at the right and bottom edges of the document window.  The scroll boxes inside the scroll bars indicate your vertical and horizontal location in the document.  You can use the mouse to scroll up and down in the document.


Size command (System menu)

Use this command to display a four-headed arrow so you can size the active window with the arrow keys.

0	After the pointer changes to the four-headed arrow:

1.	Press one of the DIRECTION keys (left, right, up, or down arrow key) to move the pointer to the border you want to move.

0	2.	Press a DIRECTION key to move the border.

1	3.	Press ENTER when the window is the size you want.

0	Note:  This command is unavailable if you maximize the window.

1	Shortcut

Mouse:	Drag the size bars at the corners or edges of the window.


Move command (Control menu)

Use this command to display a four-headed arrow so you can move the active window or dialog box with the arrow keys.

0	Note: This command is unavailable if you maximize the window.

1	Shortcut

Keys:	CTRL+F7


System Minimize Command
Minimize command (application Control menu)

0	Use this command to reduce the TestChecker window to an icon.

0	Shortcut

Mouse:	Click the minimize icon [image] on the title bar.

1	Keys:	ALT+F9


Maximize command (System menu)

Use this command to enlarge the active window to fill the available space.

0	Shortcut

Mouse:	Click the maximize icon [image] on the title bar; or double-click the title bar.

1	Keys:	CTRL+F10 enlarges a document window.


Next Window command (document Control menu)

Use this command to switch to the next open document window. TestChecker determines which window is next according to the order in which you opened the windows.

Shortcut

Keys:	CTRL+F6


Previous Window command (document Control menu)

Use this command to switch to the previous open document window.  TestChecker determines which window is previous according to the order in which you opened the windows.

Shortcut

Keys:	SHIFT+CTRL+F6


Close command (Control menus)

Use this command to close the active window or dialog box.

Double-clicking a Control-menu box is the same as choosing the Close command.

0	Note:  If you have multiple windows open for a single document, the Close command on the document Control menu closes only one window at a time.  You can close all windows at once with the Close command on the File menu.

1	Shortcuts

Keys: 	CTRL+F4 closes a document window

0	ALT+F4 closes the TestChecker window


Restore command (Control menu)

Use this command to return the active window to its size and position before you chose the Maximize or Minimize command.


Switch to command (application Control menu)

Use this command to display a list of all open applications.  Use this "Task List" to switch to or close an application on the list.

Shortcut

Keys:	CTRL+ESC

0	Dialog Box Options

1	When you choose the Switch To command, you will be presented with a dialog box with the following options:

Task List

Select the application you want to switch to or close.

Switch To

Makes the selected application active.

End Task

Closes the selected application.

Cancel

Closes the Task List box.

Cascade

Arranges open applications so they overlap and you can see each title bar.  This option does not affect applications reduced to icons.

Tile

Arranges open applications into windows that do not overlap.  This option does not affect applications reduced to icons.

Arrange Icons

Arranges the icons of all minimized applications across the bottom of the screen.


No Help Available

No help is available for this area of the window.


No Help Available

No help is available for this message box.


File Print command
Print command (File menu)

Use this command to print the content of the active window. This command presents a Print dialog box, where you may specify the range of pages to be printed, the number of copies, the destination printer, and other printer setup options.

Shortcuts

Toolbar:

1	Keys:	CTRL+P


Print dialog box

The following options allow you to specify how the document should be printed:

Printer

This is the active printer and printer connection. Choose the Properties option to change the printer and printer connection.

Setup

Displays a Print Setup dialog box, so  you can select a printer and printer connection.

Print Range

Specify the pages you want to print:

All	Prints the entire document.
Selection	Prints the currently selected text.
Pages	Prints the range of pages you specify in the From and To boxes.
Copies

Specify the number of copies you want to print for the above page range.

Collate Copies

Prints copies in page number order, instead of separated multiple copies of each page.


Generate Report dialog box

The following options allow you to specify the name and location of the file you are about to save:

Save in

0	Select the directory and drive in which you want to store the document.

1	File Name

Type a filename to generate a document with a new name.

Report

Select a format for the document to be generated, TestChecker adds the appropriate extension automatically.


Print Progress Dialog

0	The Printing dialog box is shown during the time that TestChecker is sending output to the printer. The page number indicates the progress of the printing.

1	To abort printing, choose Cancel.


File Print Preview command
Print Preview command (File menu)

Use this command to display the content of the active window as it would appear when printed.  When you choose this command, the main window will be replaced with a print preview window which displays an image of the final printout.  The print preview toolbar offers you options to view either one or two pages at a time; move back and forth through the document; zoom in and out of pages; and initiate a print job.


Print Preview toolbar

The print preview toolbar offers you the following options:

Print

Bring up the print dialog box, to start a print job.

Next Page

Preview the next printed page.

Prev Page

Preview the previous printed page.

One Page / Two Page

Preview one or two printed pages at a time.

Zoom In

Take a closer look at the printed page.

Zoom Out

Take a larger look at the printed page.

Close

Return from print preview to the editing window.


File Print Setup command
Print Setup command (File menu)

Use this command to select a printer and a printer connection.  This command presents a Print Setup dialog box, where you specify the printer and its connection.


Print Setup dialog box

The following options allow you to select the destination printer and its connection.

Printer

Select the printer you want to use.  Choose the Default Printer; or one of the current installed printers shown in the list. You install printers and configure ports using the Windows Control Panel.

Paper

Select the paper size and printer feed mode.

Orientation

Select the paper orientation.


Open Project command (File menu)

0	Use this command to open an existing project . If an existing project is currently open and has been modified, TestChecker asks whether you want to save your changes before closing it. The new project is then opened.


Save Project command (File menu)

0	Use this command to save a project. When you save a project for the first time, TestChecker displays the Save As dialog box so you can name your project.


Close Project command (File menu)

0	Use this command to close all windows containing the active project. TestChecker suggests that you save changes to your project before you close it. If you close a project without saving, you lose all changes made since the last time you saved it. Before closing an untitled project, TestChecker displays the Save As dialog box and suggests that you name and save the project


Project file

The Logiscope TestChecker project file is used to store general information about your working environment. The project is built in Logiscope Studio and mainly contains:

§	the default test startup command and related parameters,

§	the pathname of the default test directory,

§	the pathname(s) of the source files,

§	the pathname(s) of the execution result file(s) (.dyn),


Test suite

A test suite consists of a set of test results grouped together according to subjects (such as tests on various functions, tests conducted by different teams, etc.).

Grouping execution results in test suites provides an overall view of the coverage of all the tests performed.


Modified Conditions/Decisions Coverage

0	Modified Condition/Decision Coverage (MC/DC) is achieved if:

§	Every entry and exit point of the program module under consideration has been invoked at least once, and each program decision has switched to all possible outcome values at least once,

§	The program decisions having been broken down into basic boolean conditions connected by logical operators (and, or, etc.), every one of these conditions has taken all possible outcome values; every condition has acted on the outcome of the decision independently. In other words, the outcome of a decision has changed as a result of changing a single condition.


Execution result file

0	TestChecker uses execution result files to store execution results in the form of test suites . By default, these files are given the extension .dyn.


Instrumented source file

0	The instrumented file (.inst) contains the original source code and the calling instructions which allow to keep track of the various objects of the program that are used during execution (instruction blocks, paths, calls). This is the file on which the tests will be performed.


Decision-to-Decision Paths

0	A Decision-to-Decision Path (or DDP) is a sequence of instructions whose origin is the entry point of the function or a decision (such as if, while, etc.) and whose end is the exit point of the function or the next decision. No decision should be found between the point of origin and the end point.


Component

0	A component can be defined as being the smallest functional unit written in a given language: procedures, functions and tasks are all seen as components by TestChecker.


Test coverage

0	Test coverage is the percentage of executed objects (DDP or MCDC) during the tests. It is computed according to the following formula:


Project properties - General

0	Use this tab to view general information about your project. The content of the text boxes cannot be modified.

Name

Displays the name of your project file.

File

Displays the pathname of your project file.

Date

Displays the project file's creation date.


Project properties - DDP

0	Use this tab to view coverage information for the DDPs found in your source files. The content of the text boxes cannot be modified.

Coverage

Displays the overall test coverage rate achieved for the whole application.

Static DDPs

Displays the number of DDPs found during source code analysis.

Executed DDPs

Displays the number of application DDPs covered (i.e. executed by at least one test of one of the test suites currently open).


Source file properties - General

0	Use this tab to view general information about the source file currently selected. The content of the text boxes cannot be modified.

Name

Displays the name of the source file.

File

Displays the pathname of the source file.


Source file properties - DDP

0	Use this tab to view coverage information for the DDPs found in the selected source file. The content of the text boxes cannot be modified.

Coverage

Displays the overall test coverage rate achieved for the selected source file.

Static DDPs

Displays the number of DDPs found during source file analysis.

Executed DDPs

Displays the number of DDPs covered in the selected source file (i.e. executed by at least one test of one of the test suites currently open).


Component properties - General

0	Use this tab to view general information about the component currently selected. The content of the text boxes cannot be modified.

Name

Displays the name of the component.

File

Displays the pathname of the source file which contains the component.


Component properties - DDP

0	Use this tab to view coverage information about the DDPs found in the selected component. The content of the text boxes cannot be modified.

Coverage

Displays the overall test coverage rate achieved for the selected component.

Static DDPs

Displays the number of DDPs found during component analysis.

Executed DDPs

Displays the number of DDPs covered in the selected component (i.e. executed by at least one test of one of the test suites currently open).


Component properties - Tests

0	Use this tab to view the list of all tests which cover the selected component, and for each test:

§	the overall coverage improvement,

§	the coverage rate achieved for each test,

§	the name of the test.


Execution result file properties - General

0	Use this tab to view general information about the execution result file currently selected. The content of the text boxes cannot be modified.

Name

Displays the name of the execution result file.

File

Displays the pathname of the execution result file.

Date

Displays the file's creation date.


Execution result file properties - DDP

0	Use this tab to view coverage information for the code DDPs executed by the tests stored in the selected test suite . The content of the text boxes cannot be modified.

Coverage

Displays the overall test coverage rate achieved by the tests of the selected test suite.

Improvement

Displays the test coverage increase achieved by running the tests of the selected test suite, by comparison with the coverage rate obtained by the rest of the test suites in the project.


Execution result file properties - Tests

0	Use this tab to view a list of the tests in the selected test suite, and for each test:

§	the overall coverage improvement,

§	the coverage rate achieved by the test,

§	the name of the test.

0	The content of the text boxes cannot be modified.


Test properties - General

0	Use this tab to view general information about the selected test.

Name

Displays the current name of the test.

0	You can type a new name in this box, the name will change in other windows  when you click outside the test properties dialog box.

File

Displays the pathname of the execution result file which contains the test.

Date

Displays the date when the test was executed last.

0	The content of the last two text boxes cannot be modified.


Test properties - Comment

0	Use this tab to enter and view comments about the selected test.


Test properties - Execution

0	Use this tab to view information about the execution of the selected test.

Command

Displays the pathname of the command which starts up the test.

Parameters

Displays test startup command parameters.

Working directory

Displays the pathname of the test startup command's working directory.

Use standard communication pipe

Defines the communication mode used between the tested software and TestChecker. This checkbox must be checked to communicate with TestChecker Gateway.

By default, the checkbox is deselected and the communication process uses named communication pipes.


Choose directory dialog box

The following options allow you to specify which directory to open:

Directory name

Select the directory you want to open.

Drives

Select the drive where the directory you want to reach is located.

0	Click Network... to connect a new networked drive to your file system.


Test properties - DDP

0	Use this tab to view DDP coverage information for the selected test. The content of the text boxes cannot be modified.

Executed DDPs

Displays the number of DDPs covered by the selected test (i.e. executed at least once by the test).

Overall coverage

Displays the overall test coverage rate achieved by the selected test.

Test suite improvement

Displays the coverage increase achieved by the selected test, by comparison with the coverage rate obtained by the rest of the tests in the test suite.

Overall improvement

Displays the coverage increase achieved by the selected test, by comparison with the coverage rate obtained by the rest of the tests of all the test suites in the project.


Test properties - Components

Use this tab to view the list of all the components covered by the selected test, and for each component:

§	the number of DDPs executed,

§	the total number of DDPs it contains,

§	the component name.


Modified Condition/Decision Coverage window

This window comprises two separate areas, form left to right:

Boolean Expression List pane	Displays the boolean expressions of the selected component.
Condition Table pane	Displays the decision matrix for the boolean expression selected in the Boolean Expression List pane.


Boolean Expression List

Displays the boolean expressions included in the selected component.

The following information is provided for each boolean expression:

Tested	Specifies that the expression has been fully tested, in other words that all boolean combinations have been covered.
Line	Indicates the line number in the source file for the boolean expression.
Coverage	Indicates the coverage rate achieved for the boolean expression.

Boolean expressions for which full coverage has not been achieved are displayed in red characters.

See also:

Modified Condition/Decision Coverage window

Condition Table


Condition Table

This window displays tested and untested modified conditions/decistions for the selected component.

Column headers show the conditions for the Decision selected, rows list the possible boolean values (True, False, - and *) for these conditions. The leftmost column indicates whether the condition was tested and the rightmost column gives the possible outcomes of the decision.

Untested conditions are displayed in red characters.

See also:

Modified Condition/Decision Coverage window

Boolean Expression List


To create a test suite

1	Click on [image].
A test suite, called by default Tchk1, is created in the project window .

2	In the Build menu, click Settings.
The Settings dialog box appears.

3	Select the Test tab to enter the parameters of the tests you are going to create.

4	Click OK.

5	Choose the project window's Tests tab and double-click Tchk1.

6	Click the [image] toolbar button.
The Save As dialog box appears on the screen.

7	In the File name box, enter a name for the new test execution result file .

8	Click Save.


To create and run a test

1	In the Test tab page of the project window, select an execution result file (identified by the extension .dyn)

2	Click on [image].
A test, called by default TEST_1 is created in the project window .

3	Click on [image] to launch the test.
The program to be tested starts up.

4	When the test is complete, double-click TEST_1 in the project window to see the coverage obtained by component .

NOTE

If the selected test has been run before, select the Edit - Reset Test. Coverage results are cleared and you are able to restart the test.


To rename a file or a test

1	In the project window , click the name you want to change.

2	From the View menu, select Properties....
The properties dialog box is displayed.

3	In the Name text box type a new name.

4	Close the dialog box to apply the change.


To move a test around your project

In TestChecker, moving tests from a file to another is a fairly straightforward business. Beside the standard cut and paste command, you can drag tests across windows and drop them anywhere you want. Here is how:

1	Make sure your project contains at least two execution result files and that they are currently open .

2	In the project window , double-click the execution result file names to open the corresponding result windows.

3	To move a test from one of the files to the other, click the identifier of a test in one of the result windows, drag it to the other and release the mouse button.

The selected test is moved to the target window. Your changes will be written to the disk files when you click the Save All command from the File menu.


To insert a test suite into a project

1	Click on [image].
The Open file dialog box appears on the screen.

2	In the Files of type drop-down list, select the Test Execution Result (.dyn) item.
All the test execution result files contained in the current directory appear in the dialog box.

3	Select one or several of these files.

4	Click Open.

The test suite(s) contained in the selected execution result file(s) are added to the project and can be seen in the project window .

TIP

You can also drag the file into TestChecker from the Windows Explorer.


To remove a test suite from the project

1	In the project window , click on the name of the test execution result file you want to remove from your project .

2	Click

The execution result file is removed from the project.

NOTE

The information is removed from the project but the file is not deleted. You can decide to drag it back into the project at any time.


To produce Code Coverage Result files

To produce an instrumented program to be used with TestChecker :

?	from Microsoft Developer Studio 6.0

?	from Logiscope Studio


From Microsoft Developer Studio 5.0
From Microsoft Developer Studio 6.0

Create a Project Configuration for the Result Files

In Visual C++, create a new project configuration as follows:

1	Load your project into Visual C++.

2	Select the Build - Configurations command.

3	Click the Add... button.

4	Choose a name for the new configuration (Logiscope for instance).

5	In the Copy Settings From field, choose the configuration which suits your needs best .

6	Click the OK button.

7	Click the Close button.

8	Make this configuation active by selecting it in the list box located on the ribbon or by the Build - Set Active Configuration command.

Start the Instrumentation

To produce the result files, select the Tools - Build Instrumented Binary command.

NOTE

Please refer to the Logiscope Settings online help for information on further result processing.


From Logiscope Studio

Please refer to Logiscope TestChecher Getting Started.


TestChecker Gateway Statup Syntax
Logiscope TestChecker Gateway Statup Syntax

TestChecker Gateway is a program run from TestChecker instead of the instrumented executable file. It manages the exchange of information between the instrumented file being executed on the target machine and TestChecker.

The startup command, to be typed in the Test Settings dialog box, is as follows:

TcGatWay

[-serial channel  [-mode mode ]] |

[-tcp ] |

[[-host host ] -port service ] |

[-host host  [-port service ]] |

[-prefix string ]

Examples


-serial Option

-serial channel

Uses serial communication link. channel specifies the communication channel name (COM1, COM2, etc.).


-mode Option

-mode mode

Sets baud rate, parity type, number of stop bits and number of data bits for the communication channel.

The default value is 9600,N,1,8.


-tcp Option

-tcp

Uses the TCP protocol.

This is the default option if the -host or -port option is specified.


-host Option

-host host

Host interface hostname or IP address.

If this option is not specified, TcGatWay listens on all interfaces.


-port Option

-port service

Service name or port number.

By default, the port number is 6309.


-prefix Option

-prefix string

Sends all the message lines which do not begin with string to the standard output.

Useful for multiplexing a serial link.


TestChecker Gateway Command Examples

TcGatWay -tcp

Wait for the target to connect to port 6309.

TcGatWay -serial COM2

Use COM2 as the communication channel.