Copyright © 1996-2002 Rational Software Corporation. All rights reserved.

Rational, the Rational logo, Purify, Quantify, PureCoverage, Rational Visual Test, Rational Robot, and ClearQuest are trademarks or registered trademarks of Rational Software Corporation in the United States and in other countries.

Visual C++, Windows, Windows NT, Developer Studio, Visual Studio, .Net and Microsoft are trademarks or registered trademark of the Microsoft Corporation. All other names are used for identification purposes only and are trademarks or registered trademarks of their respective companies.

U.S. Registered Patent Nos. 5,193,180 and 5,335,344 and 5,535,329. Licensed under Sun Microsystems Inc.'s U.S. Pat. No. 5,404,499. Other U.S. and foreign patents pending.

README for PurifyPlus 2002.05.20 for Windows

---

TABLE OF CONTENTS

---

1. What's new in PurifyPlus?
2. Requirements
3. Installing PurifyPlus
4. Contacting Technical Support

Back to Top

New in Purify 2002.05.20:

• PurifyPlus is now fully integrated with the Microsoft Visual Studio .NET IDE, enabling developers to monitor applications without having to leave the IDE. Standalone GUIs for each of Purify, Quantify and PureCoverage are also provided.
  
  
• Support has been added for Sun JDK1.4 (both the client and server versions).
  
  
• A preview version of an ASP.NET profiling monitor (AspNetMon.exe) is included in this release. This monitor enables PurifyPlus profiling for managed code running in the context of ASP.NET or as a Web Service.

  The monitor is implemented as a Windows system tray icon. To start the monitor, first ensure that the individual product install directories (e.g. C:\Program Files\Rational\Purify) are in the SYSTEM path, then run AspNetMon.exe. After the monitor is started, a small traffic light icon appears in the system tray area of the Windows taskbar. The red light indicates profiling is disabled for all PurifyPlus products. The green light indicates profiling is enabled for one of the products (Purify, Quantify, or Coverage). Hover the mouse cursor over the monitor icon to view the current monitor status (enabled or disabled), and the product name for which profiling is enabled (Purify, Quantify, or Coverage).

  To change the monitor status, right-click the monitor icon in the system tray. A popup menu displays the following choices:

  • ASP.NET Monitoring Disabled
  • Enable ASP.NET Monitoring for Quantify
  • Enable ASP.NET Monitoring for Coverage
  • Enable ASP.NET Monitoring for Purify

  Choose "ASP.NET Monitoring Disabled" to disable profiling for all PurifyPlus products, or choose "Enable ASP.NET Monitoring for " to enable profiling for one of the products.

  Once started, the monitor will continue to run until the operating system is rebooted. To start the monitor automatically, place a shortcut to AspNetMon.exe in the startup folder of the All Users > Start Menu.

  In order to obtain data for your ASP.NET application, you need to either take a snapshot from the individual product GUIs or disable the monitor as described above.
  
  

• Refer to the Readme.html files in the installation directories of the individual products for details on new functionality that has been added which is specific to the given product.

New in PurifyPlus 2002.05.00:

• Support has been added for .NET Beta 2 applications (both managed and unmanaged). Because .NET is still a beta product and will continue to evolve after the release of PurifyPlus, please visit the Rational .NET Solution Center for access to the most up-to-date information regarding Rational's support of .NET.

• Support has been added for the Visual C++ .NET compiler.

• Support has been added for Windows XP Professional.

  Refer to the Readme.html files in the installation directories of the individual products for details on new functionality that has been added which is specific to the given product.

New in PurifyPlus 2001A.04.00:

PurifyPlus is a new independently installable Rational product that includes the functionality of Rational Purify, Quantify and PureCoverage. Once installed, each of the products can be used with a single PurifyPlus license.

Refer to the Readme.html files in the installation directories of the individual products for details on instrumenting and running programs.

Back to Top

• Intel Pentium processor
• One of the following Operating Systems
  • Microsoft Windows NT 4.0 with Service Pack 6a or greater
  • Microsoft Windows 2000
  • Microsoft Windows XP Professional
• 256 Mb RAM recommended
• Approximately 100 Mb free disk space
• 100Mb minimum swap space recommended

Notes:

• You will need additional disk space to accommodate a growing cache directory as you instrument more programs.

• PurifyPlus does not support checked builds of Windows.

• PurifyPlus for Windows supports:

  Architecture:	Win32 programs only
  Compilers:	Microsoft Visual C++ 6.0 Microsoft Visual C++ .NET Microsoft Visual Basic 6.0sp3 (Quantify and PureCoverage only)
  Interpreters:	Microsoft Visual Basic 6.0sp3 (Quantify and PureCoverage only) Microsoft virtual machine for Java. The version for Msjava.dll should be 2828 or later. The latest release of the virtual machine and SDK is available at: http://www.microsoft.com/java/download.htm Sun JVM 1.2.2 and higher. When running on the Pentium 4 with JDK 1.2.2, build 007 is required. Previous versions of 1.2.2 will not run on Pentium 4.
  Debuggers:	Visual C++, WinDBG, NTSD
  Debug formats:	COFF, CV4
  Debug files:	Debug data can be placed in .exe, .pdb, or .dbg files. PurifyPlus can also use .map files, if available.

Back to Top

To install PurifyPlus:

1. Verify that your swap space is set to at least 100Mb, the minimum recommended.
2. Run Setup.exe and follow the onscreen instructions.

Notes:

• You are installing a licensed Rational Software product. The product you have purchased includes either a node-locked or floating license. Please refer to the instructions in the Startup License Key Certificate (included in the product package) for installing a startup license key to get started using the product.

  For detailed information about Rational Software licensing and how to work with node-locked and floating licenses, please refer to the Rational License Key Administrator online Help (Licadmin.hlp), available by clicking the Help button in the Rational License Key Administrator.

• The Rational Solutions for Windows install disk includes numerous Rational Software products. However, the startup license key you received can be used to run only the product you purchased. If you would like to install and evaluate other Rational Software products that are available on the install disk but that you have not purchased, please contact Rational Software.

• If you have licensing questions and problems and you can't find the solution in the License Key Administrator online Help, please contact Licensing Support. For contact information, look up "contacting" in the Rational License Key Administrator online Help index.

• PurifyPlus must be installed after Visual C++ and Visual Test in order for it to install an integration with these tools. If you installed one of these tools after PurifyPlus, simply re-install PurifyPlus to get the integration.

• PurifyPlus can be installed as part of Rational Suite DevelopmentStudio. When you do a custom install of Rational Suite DevelopmentStudio, and you choose to install only PurifyPlus, Rational Software Setup installs additional components that are not used by PurifyPlus. For example, SQL Anywhere.

• To uninstall a previous copy of PurifyPlus for Windows, double-click the Add/Remove Programs icon in the Control Panel and uninstall PurifyPlus. The uninstall program removes all of the files associated with the PurifyPlus installation.

  If you do not do an uninstall, but instead install a new version of PurifyPlus over a previous version, be sure to delete all files in the cache directories of each of Purify, Quantify and PureCoverage first. Your application and its modules must be reinstrumented after installation to operate correctly with the current release of PurifyPlus.

Back to Top

If you have a technical problem and you can't find the solution in online Help, you can contact Technical Support.

The Americas:
       Rational Software
       18880 Homestead Road
       Cupertino, CA 95014
       voice: (800)433-5444
       fax: (408)863-4001
       email: support@rational.com

Europe and Middle East:
       Rational Software
       Beechavenue 30
       1119 PV Schiphol-Rijk
       The Netherlands
       voice: +31 (0)20-454-6200
       fax: +31 (0)20-454-6201
       email: support@europe.rational.com

Australia and Asia Pacific:
       Rational Software Corporation Pty Ltd,
       Zenith Centre, Level 13,
       821 Pacific Highway,
       Chatswood NSW 2067,
       Australia
       voice: +61 02-9419-0111
       fax: +61 02-9419-0123
       email: support@apac.rational.com

If you email, include the license information that appears in the "Help > About Rational Purify/Quantify/PureCoverage" dialog along with the log file.

Before you call:

1. Note the sequence of events that led to the problem and any program messages or error view messages displayed.

2. Have your license key and customer number ready and, if possible, the product running on your computer.

• If you have licensing questions and problems and you can't find the solution in the License Key Administrator online Help, please contact Licensing Support. For contact information, look up "contacting" in the Rational License Key Administrator online Help index.