Version 2003.06.01
This is a Service Release
The product changes described in this document apply to version 2003.06.00 of the Rational PurifyPlus Family of products. This service release will update the PurifyPlus Family to version 2003.06.01.
Members of the PurifyPlus Family include:
References to PurifyPlus in these release notes applies to Purify, Quantify and PureCoverage.
This release is intended to fix defects in version 2003.06.00 of the Rational PurifyPlus Family. See Resolved Issues in This Release for a list of the defects that have been fixed.
The Hardware/Software requirements for this service release include the following additions to the supported platforms. For the base list see 2003.06.00 Hardware/Software Requirements.
| Item | Additions to Base Support | ||
|---|---|---|---|
| Integrations with 3rd Party Applications | Compilers
|
||
Debuggers
|
|||
| IDEs and Application Servers | Integrated Development Environments
|
||
| Run-time Environments |
|
||
See the Rational Suite Release Notes for details on installation.
Note: If you have recently installed a Rational product, you must restart your system before applying this service release. Do not apply this service release until you have restarted your system after installing a Rational product.
The compatibility issues in this service release are unchanged from the 2003.06.00 Compatibility Issues.
The restrictions and guidelines in this service release are unchanged from the 2003.06.00 Restrictions and Guidelines.
The following table lists the known issues from the 2003.06.00 version of the Rational PurifyPlus Family. Issues in this list that were resolved in the service release are grayed out.
| Topic | Applies To | Defect Number | Description |
|---|---|---|---|
| Debugging | PurifyPlus | RATLC00031747 | When debugging a managed application from within Visual Studio .NET, setting breakpoints and single-stepping will not work if PurifyPlus is engaged. This problem is unique to Visual Studio .NET. Debugging works as expected in Visual Studio .NET 2003, RC3. |
| Debugging | PurifyPlus | RATLC00369792 | Within Visual Studio .NET and Visual Studio .NET 2003, the PurifyPlus engage button does not work for unmanaged applications. In order to run an unmanaged application with PurifyPlus engaged, the Run menu item should be selected for one of the PurifyPlus Family products. As an example, to run an unmanaged application with Purify engaged, select PurifyPlus>Purify>Run. In order to debug an unmanaged application with Purify engaged, the application must be run from the standalone Purify GUI with Run under the debugger checked in the Run dialog. It is currently not possible to debug an unmanaged application with PureCoverage or Quantify engaged. |
| Instrumenting java.exe, javaw.exe | PurifyPlus | RATLC00512789 | When instrumenting java.exe or javaw.exe in order to collect run-time data on native code, PurifyPlus fails to find jvm.dll. To circumvent this problem, add the directory containing jvm.dll along with the PurifyPlus cache directory to the user PATH environment variable. |
| Selective instrumentation and ASP.NET | PurifyPlus | RATLC00370331 |
Using PurifyPlus to selectively instrument ASP.NET applications does not work. The options necessary to enable
this feature are not properly passed to the running application. This problem can be circumvented by setting
a system environment variable. For Purify, this can be accomplished with the following:
PURIFYOPTIONS=sys_ini_filename="<User Profile>\Application Data\Rational\Purify\purifyw_pure.ini" Where <User Profile> is the system-returned location for the Windows user profile directory. |
| Broken XDE functionality | PurifyPlus | RATLC00239418 Fixed in 2003.06.01 |
Uninstalling PurifyPlus can break functionality in Rational XDE. If after uninstalling PurifyPlus, you see the
XDE error "Modeler Error" or if you are unable to publish a model, do the following to restore the functionality:
|
| Extra PurifyPlus session with XDE Tester | PurifyPlus | RATLC00371993 Fixed in 2003.06.01 |
When PurifyPlus is used with XDE Tester, an extra PurifyPlus session is initiated for the browser that displays
the XDE Tester log. To suppress this session, edit the profile.ini file in the PurifyPlus directory (typically
C:\Program Files\Rational\PurifyPlus). In the CommandLineStopList section add the line:
XDETesterPat=log.htm |
| Profiling .NET application running as a Service | PurifyPlus | RATLC00031871 |
In order to correctly profile a .NET application running as a Windows Service, perform the following steps:
where <Product> is one of Purify, Quantify or PureCoverage. where <Basename of EXE> is the basename of your service executable (e.g. foo is the basename of foo.exe.) |
| Uinstall does not remove .NET integration | PurifyPlus | RATLC00372000 | When PurifyPlus is uninstalled, the .NET integration is not completely removed. To clean out the remaining PurifyPlus menus and toolbar entries, run devenv /setup. |
| ASPNetMon does not work with ASP.NET 2003 | PurifyPlus | RATLC00446505 Fixed in 2003.06.01 |
PurifyPlus is unable to collect profiling information through the ASPNetMon utility for Microsoft ASP.NET 2003.
As a workaround, perform the following steps:
where <Product> is one of Purify, Quantify or PureCoverage. |
| JNI | Quantify | RATLC00369104 | When profiling native code invoked through Java's JNI interface, the Java runtime may throw an exception and abort. This is a known problem that can be worked around by specifying the Quantify option /profiler-runtime-flags=4 when instrumenting the native code. This may cause the Descendant time for functions that return back through JNI to appear larger than normal. The function time, however, will still be correct. |
| Data Set operations | Quantify | RATLC00369110 | Data set operations such as focus and delete subtree data can change F and F+D times or even eliminate certain functions that have annotated source. Currently all the data collected at line level is NOT changed during data set operations (it reflects the totals over the entire dataset). |
In addition to the issues resolved on the known issues list above, the following issues were also resolved in this service release.
| Product | Defect Number | Description |
|---|---|---|
| PurifyPlus | RATLC00051688 | XDE Tester will not record a user action against an instrumented application if there are two JDKs installed. |
| PurifyPlus | RATLC00370380 | Purified application crashes with Outlook XP. |
| PurifyPlus | RATLC00371246 | PurifyPlus Navigator context menu items missing in Microsoft Visual Studio .NET. |
| PurifyPlus | RATLC00371516 | PurifyPlus cannot handle managed modules linked into a native application on Microsoft Windows XP SP1. |
| PurifyPlus | RATLC00371993 | PurifyPlus should not monitor the XDE Tester browser session. |
| PurifyPlus | RATLC00372422 | PurifyPlus pulldown menu accelerator conflicts with pre-existing accelerator in Microsoft Visual Studio .NET. |
| PurifyPlus | RATLC00372495 | PurifyPlus does not support Microsoft Terminal Services in Application Server mode. |
| PurifyPlus | RATLC00372701 | Purify fails with "Duplicate insert" message in application running on Windows 2003 Enterprise Server. |
| PurifyPlus | RATLC00372707 | Applications that suspend threads sometimes deadlock when instrumented with PurifyPlus. |
| PurifyPlus | RATLC00372775 | Selecting WebSphere Preferences dialog brings it up on top of the PurifyPlus Preferences dialog. |
| PurifyPlus | RATLC00513290 | PurifyPlus Navigator nodes do not disappear on "close all" from context menu. |
| PurifyPlus | RATLC00514239 | Microsoft Windows .NET application which contains a source file path name greater than 128 characters crashes if instrumented with PurifyPlus. |
| Purify | RATLC00368467 | CAD application exits with a fatal error when instrumented with Purify. |
| Purify | RATLC00371507 | Garbage Collect and Snapshot menu items are disabled in WebSphere and Microsoft Visual Studio .NET when a Java or managed application is run using the Run Program dialog. |
| Purify | RATLC00371753 | Garbage Collect menu item stays disabled after doing garbage collection within WebSphere or Microsoft Visual Studio .NET. |
| Purify | RATLC00371782 | Annotated source menu item enable/disable state is not immediately synchronized with view's context menu. |
| Purify | RATLC00372552 | Purify fails with "Trap bits found in live chunk" message in application that invokes MapViewOfFile() with a region that is smaller than the region previously mapped at a given address. |
| Purify | RATLC00371532 | Application using nested exceptions crashes when instrumented with Purify. |
| Purify | RATLC00371908 | Need to add support for the -ExitOnError option to Purify. |
| Purify | RATLC00371924 | Multithreaded applications that make extensive use of VirtualAlloc() and VirtualFree() crash when instrumented with Purify. |
| Quantify | RATLC00372068 | Application hangs when instrumented with Quantify. |
There are no known documentation issues at this time.
The additional information section in this service release is unchanged from the 2003.06.00 Additional Information.
If you have questions about installing, using, or maintaining this product, contact Rational Technical Support as follows:
| Your Location | Telephone | Facsimile | |
| North America |
(800) 433-5444 (408) 863-4000 |
(781) 676-2460 |
support@rational.com |
| Europe, Middle East, Africa | + 31 (0) 20 4546 200 |
+31 (0) 20 4545 202 |
support@europe.rational.com |
| Asia Pacific | +61 2 9419 0111 |
+61 2 9419 0123 |
support@apac.rational.com |
When you contact Rational Technical Support, please be prepared to supply the following information: