Preface

What's in this guide?

Audience

Other resources

Contacting Rational technical publications

Contacting Rational technical support

Installing the products

The basic steps

Information you need for AccountLink

Obtaining a .upd file using AccountLink

Information you need for rs_install

Installing the products using rs_install

Answers to questions about rs_install

After you install: Post-installation tasks

For Rational PurifyPlus

For Rational Purify, PureCoverage, and Quantify

Maintaining the rational.opt options file

Modifying the list of user names

Removing a previous product release

Requesting and installing the permanent or TLA license key

Requesting your permanent or TLA license key

Entering a permanent or TLA license key after initial installation

Supplemental notes

Creating an installation directory manually

Mounting the CD-ROM

Ejecting the CD-ROM

Using rs_install commands

Using the FLEXlm Software License Manager

Using Rational Purify

Rational Purify: What it does

Finding errors in Hello World

Instrumenting a program

Compiling and linking in separate stages

Running the instrumented program

Seeing all your errors at a glance

Finding and correcting errors

Understanding the cause of the error

Correcting the ABR error

Finding leaked memory

Correcting the MLK error

Looking at the heap analysis

Comparing program runs

Suppressing Purify messages

Saving Purify output to a view file

Saving a run to a view file from the Viewer

Opening a view file

Using your debugger with Purify

Using Purify with PureCoverage

Purify API functions

Build-time options

Conversion characters for filenames

Run-time options

Purify messages

How Purify finds memory-access errors

How Purify checks statically allocated memory

Using Rational PureCoverage

Rational PureCoverage: What it does

Finding untested areas of Hello World

Instrumenting a program

Running the instrumented program

Displaying coverage data

Expanding the file-level detail

Examining function-level detail

Examining the annotated source

Improving Hello World's test coverage

Using report scripts

Build-time options

Run-time options

Analysis-time options

Analysis-time mode options

Using Rational Quantify

Rational Quantify: What it does

How Quantify works

Building and running an instrumented program

Interpreting the program summary

Using Quantify's data analysis windows

The Function List window

Sorting the function list

Restricting functions

The Call Graph window

Using the pop-up menu

Expanding and collapsing descendants

The Function Detail window

Changing the scale and precision of data

Saving function detail data

The Annotated Source window

Changing annotations

Saving performance data on exit

Comparing program runs with qxdiff

Build-time options

qv run-time options

Run-time options

API functions