Contents

Preface

Guide to Quality and Peformance

CommonPoint information set

Getting started

Taxonomy

Developer guides

Usage and tools guidelines

Application documentation

Documented sample programs and sample code

Installation and late-breaking information

Typographical conventions

Reading notation diagrams

part 1 - Test Environment

Test environment introduction

Test framework quick start

Writing a simple test

Building the SimpleTest program

Writing a test function

Test framework concepts

Target class and test class

Decision functions

Creating a base test class

Test framework checklist

Test framework classes

TTest class

Test collection classes

Timing tests

Protocol tests

Related classes

Include files

Developing tests

About the sample code

Creating a test class

SampleObjectTest.h

SampleObjectTest.C

Overriding inherited TTest member functions

Identifying what a test does

Predefined test information keys

Creating CopyInfo keywords

Setting up the environment

Passing text input to a test

Parsing simple arguments to a test

Parsing keyed options to a test

Parsing nonkeyed options to a test

Cleaning up after a test

Writing text to the console

Output samples

Default level

Head level

Detail level

Debug level

Selectively writing test output to a log file

Using TTieredTextBuffer in non-TTest classes

Writing from multiple threads in the same task

Building the test

Testing object protocols

Testing a class that uses the default comparator and streamer

Using the protocol test macros

Deriving from the protocol test classes

Protocol test options

Hash value checking

Primitive comparison checking

Stream-in version checking

Combining tests

Using a script to run multiple tests

Combining multiple TTest objects into a single test

Creating an unordered group of tests

Creating an ordered list of tests

Creating tests with dependencies on other tests

Combining operations in a single test class

Handling exceptions

Timing test concepts

Accuracy

Tolerance

TTimingTest command line arguments

Creating a timed test

Controlling a timed test

Timing a single event

Timing multiple events

Performing tests

RunTest options

RunTest exit value

CreateTest options

Protocol test options

Performing a test

Testing an interface inherited from a base class

Stopping a test

Providing input for a test

Displaying information about a test

Examining test results

Creating a test log

Printing a test report

Printing the backup test log

Clearing the test log

Writing a test script

part 2 - Exception Handling

Exception handling

part 3 - Heap Analysis

Heap analysis tools

Heap analysis

Tools

Limitations

TLocalHeapMonitor

TLocalHeapAnalyzer

Heap monitoring file format

Heap analysis file format

Heap corruption

Debugging heap corruption

AIX notes

Dynamic analysis

Dynamic typing

Dynamic error detection