Rational XDE Service Release 2002.05.21 Release Notes

July 2002

This software contains proprietary and confidential information of Rational and its suppliers. Use, disclosure or reproduction is prohibited without the prior express written consent of Rational.

Scope

This document contains release notes specific to the Rational Web Publisher Download. This service release is centered around the Rational® XDE™ Web Publisher and Reporting capabilities.

Scope. 1

Hardware/Software Information. 2

Client Requirements. 2

Hardware Requirements. 2

Software Requirements. 2

Getting Started. 2

Installation Information. 3

Applying Service Releases to Supported Configurations. 3

Installing an Additional Product to an Updated System.. 3

Applying Service Releases to Unsupported Configurations. 4

Rational Software Setup Service Release Requirements. 4

Using the Rational Software Setup Program.. 4

Ensuring Version Compatibility. 4

Possible Restart Required. 5

Deploying a Service Release in the Silent Mode. 5

Removing a Service Release. 5

Installation Issues. 6

Compatibility Issues. 6

With Rational Products. 6

With Third-Party Products. 6

Late Changes to Documentation. 6

Restrictions and Guidelines on Using this Patch. 6

Defects and Changes. 6

Defects fixed in this release. 6

Known issues in this release. 7

Additional Information. 8

Contacting Rational Technical Support 8

Legal Information. 8

Hardware/Software Information

Client Requirements

Hardware Requirements

This release has no additional hardware requirements beyond Rational XDE v2002 (2002.05.20).

Software Requirements

This release has no additional software requirements beyond Rational XDE v2002 (2002.05.20).

Also, see section below on compatibility with Rational products. 6.

Getting Started

This download consists of the following components:

· A zip file containing Rational XDE Web Publisher Download. A URL to this installation is provided on the Rational Beta web page.

A Service Release, similar to a synchronized patch, is developed for a specific product-version and does not affect the licensing of your products. Since there is no effect on licensing, the Service Release program does not let you configure licensing while you apply it to the software.

The Service Release updates the Rational product’s version number from, for example, 2002.05.00.305.000 to 2002.05.01.305.000. You can see the change in the About Rational Product dialog in the toolbar’s Help pull-down menu or in the Rational Installed Product Information dialog on the Start menu.

Installation Information

To determine what version of Rational products you currently have installed, please go to "Start" -> "Programs" -> "Rational <Product Title>" -> "Rational Software Installed Product Information".

Release notes for all products can be accessed via <http://www.rational.com/support/documentation/index.jsp>. Scroll down to “View Documentation OnLine”, go to the “Documentation” drop down box and select “View all v2002 documentation”. Select the appropriate product name and all release notes pertaining to this service release will be identified by the word “Service Release” in their description.

Make certain that you have reviewed all of these release notes before proceeding with the installation of this service release.

If you interrupt the InstallShield Wizard while it is extracting files, the installation program will crash.

· To stop the installation, allow the InstallShield Wizard to complete and, when the Rational Software Setup program starts, click Cancel.

· To restart the installation procedure, double-click on the service release installation icon.

You will also not be able to uninstall this service release. To revert to your previous configuration, uninstall all your Rational Suite products for which the Service Release has been applied, and reinstall the original Rational product version.

Applying Service Releases to Supported Configurations

This section provides guidelines for installing Rational Service Releases.

· If you are an administrator, find Service Releases at http://www.rational.com/support/downloadcenter/index.jsp. You must have administrator privileges to download the program from this web site. This web site and the Service Release program provide the release notes for each Service Release.

· If you are a client user, speak to your system administrator before you try to download a service release from the Rational web site.

You can apply Service Releases to these configurations:

· Typical, Custom, and Compact installation types.

· Installations where earlier Service Releases have been applied.

Note: You can copy the Service Release program to a directory on the network, but you cannot configure the Service Release program for a network installation type.

Installing an Additional Product to an Updated System

When you install an additional product from the Rational Solutions for Windows CD-ROM to a system that already has had a Service Release applied to it, the Setup program warns you that the products on your system are updated. Continue with the installation and then re-apply the Service Release to update the additional product.

Applying Service Releases to Unsupported Configurations

If the Service Release detects an unsupported configuration, such as a network installation, it cannot update the components. Instead, the program displays a warning message about the incompatibility between the Service Release and the installed products.

You cannot apply a Service Release to:

A product-version for which it was not intended.
A specific product if you have multiple products on one system.
A directory that was configured for a network installation type.
Multiple versions of Rational Software (but no Service Releases) on the same system.

A system that had a more current Service Release applied to it. That is, applying an earlier Service Release to a later Service Release is not supported.

Rational Software Setup Service Release Requirements

The following general requirements are necessary to run the Rational Software Setup Service Release on your system.

To download software from the Rational web site, you must have a log in identity and password.
Ensure that all Rational products on your system are upgraded to the same version. You cannot apply the service release until all Rational products are the same version.
Make sure you have administrator privileges before you update your Rational products.

Note To use the Rational Software Setup program on a Windows NT, 2000, or XP system, you must have Windows administrator privileges on the local system. Log in as one of the following users:

· Local administrator

· Member of the local administrator’s group

· Domain administrator who is a member of the local administrator’s group

Make sure that you have a current backup of your Registry and system directories.
Ensure that other programs are not running before you start the program.

Turn off all virus protection software. These programs often run in the background and interfere with the installation and file decompression process.
Turn off any user interface managers or desktop environments that run on top of Microsoft Windows.
Change to a standard VGA video driver while Rational Setup is running, or disable video features such as virtual screens or screen switching.
Change to a standard mouse driver, or disable special mouse features that perform tasks such as leaving pointer trails or changing pointer sizes.

Using the Rational Software Setup Program

Ensuring Version Compatibility

If the Rational Software Setup program detects differing versions of Rational software on your system, you will see a message. For each of the Rational products listed in the dialog box, remove the product or upgrade the product. You cannot apply the service release until these products have been either removed or upgraded. Click OK and then:

Remove it: Remove the software using Control Panel > Add/Remove Programs.

Upgrade it: Upgrading each product updates all necessary files, registry entries, startup menu items, and shared components on your system. Do not run any of the products until all have been upgraded because some of the non-upgraded products may stop working.

The Rational Software Setup dialog box provides general information about the software installation.
The Confirmation dialog box displays the products to be updated.

Possible Restart Required

If files required for the update are in use during the Rational Software Setup program, and if the program needs to install shared components on your system, the Setup program may need to restart your system.

Note The Rational Software Setup gives you the option to restart your system. However, the Setup program will not finish updating your Rational products until you restart the system.

After the restart, the installation process completes on your system. Click Finish to exit from the Rational Software Setup program.

· The Installation Complete screen provides links to the Rational Support web site and the Rational Developer Network registration site.

· The check box to view the product release notes is also enabled.

Removing a Service Release

You cannot uninstall just the Service Release from your system. To uninstall the Service Release, uninstall all Rational products from your system and then re-install the products.

Installation Issues

This release has not been tested on Windows 2000 Server, Windows 2000 Advanced Server, or any non-English Windows operating systems. However, there are no known issues on those platforms.

Compatibility Issues

With Rational Products

This Service Release cannot be installed by customers who have Rational Solutions for Windows v2002 Synchronized Service Release 1 or earlier. Please contact Upgrades Support at one of the above listed numbers for a new Rational XDE v2002 Release 2 product CD.

With Third-Party Products

None.

Late Changes to Documentation

None.

Restrictions and Guidelines on Using this Service Release

None.

Defects and Changes

Defects fixed in this release

Category	ID	Description
Install	88664	This release fixes an issue for users of Rational XDE and IBM WSS AD.
XDE Modeler	87122, 87425	This update to XDE corrects three defects that may lead to data loss in some situations: For users of Rational XDE on Visual Studio.NET this service release corrects the following problems: · Closing Visual Studio.NET by using the close application button (X in the upper-right hand corner) could lead to data loss if storage units of a model have unsaved changes, yet the model root unit has no unsaved changes. In XDE v2002, users would not be prompted to save changes. · Similar to the above issue, if a user selects "Save All" in a Solution Items project, unsaved changes in storage units will not be saved unless the model root unit itself has unsaved changes.
XDE Modeler	87580	For users of Rational XDE installed on WebSphere Studio Workbench or WebSphere Studio Application Developer this service release corrects the following problems: · XDE v2002 ignored read-only attribute of files, and allowed users to over-write read-only models.
Web Publisher Reporting	76977	The version of web publisher provided in the XDE v2002 Product did not support the ability to navigate the published model using “hot spots”. This ability to drill down by clicking the published diagrams is now supported.
	85757	This update to XDE provides a performance improvement for Web Publisher. Published models are now from 60% to 30% smaller than in previous versions.
	81000, 85467, 87689, 87911	This update fixes a number of defects in the product relating to the operation of the Web Publisher capability. This service release corrects the following problems: · Previously it was not possible to close XDE after successfully publishing a model while running on Windows NT 4. · The XDE v2002 release had certain coexistence issues with previous Rational Suite products. · Web Publisher in XDE v2002 did not remove all temp files after publishing a model. · Models did not correctly publish from the WSS AD shell when extended (international) characters were used.
	82793, 84936, 86941, 87453	This update fixes a number of defects in the product relating to the content produced by the Web Publisher capability. This service release corrects the following problems: · Models with broken unit elements could not be published successfully. · Certain tree views of published models were not displayed correctly. · Text-only elements did not publish correctly. · Certain large diagrams did not publish correctly.

Known issues in this release

Category	ID	Description
Web Publisher	87187	Printing published models from the browser may result in the tree pane not being printed. This is a JVM limitation as documented by the JVM vendor(s).

Additional Information

Contacting Rational Technical Support

If you have questions about installing, using, or maintaining this product, contact Rational Technical Support as follows:

Your Location	Telephone	Facsimile	E-mail
North America	(800) 433-5444 (toll free) (408) 863-4000 Cupertino, CA	(781) 676-2460 Lexington, MA	support@rational.com
Europe, Middle East, Africa	+ 31 (0) 20 4546 200 Netherlands	+31 (0) 20-4545-201 Netherlands	support@europe.rational.com
Asia Pacific	+61-2-9419-0111 Australia	+61-2-9419-0123 Australia	support@apac.rational.com

When you contact Rational Technical Support, please be prepared to supply the following information:

Your name, company name, telephone number, and e-mail address
Your operating system, version number, and any service packs or patches you have applied
Product name and release number
Your case ID number (if you are following up on a previously reported problem)

Legal Information

TRADEMARKS

Rational, Rational Software Corporation, Rational the e-development company, Rational Developer Network, ClearCase, ClearCase Attache, ClearCase MultiSite, ClearDDTS, ClearQuest, ClearQuest MultiSite, DDTS, Object Testing, Object-Oriented Recording, ObjecTime & Design, Objectory, PerformanceStudio, Rational ProjectConsole, PureCoverage, PureDDTS, PureLink, Purify, Purify'd, Quantify, Rational Apex, Rational CRC, Rational Rose, Rational Suite, Rational Summit, Rational Visual Test, Requisite, RequisitePro, RUP, SiteCheck, SoDA, TestFactory, TestFoundation, TestMate, The Rational Watch, AnalystStudio, ClearGuide, ClearTrack, Connexis, e-Development Accelerators, ObjecTime, Rational Dashboard, Rational PerformanceArchitect, Rational Process Workbench, Rational Suite AnalystStudio, Rational Suite ContentStudio, Rational Suite Enterprise, Rational Suite ManagerStudio, Rational Unified Process, XDE, SiteLoad, TestStudio, VADS, among others, are either trademarks or registered trademarks of Rational Software Corporation in the United States and/or in other countries. All other names are used for identification purposes only, and are trademarks or registered trademarks of their respective companies.

Microsoft, the Microsoft logo, Active Accessibility, Active Client, Active Desktop, Active Directory, ActiveMovie, Active Platform, ActiveStore, ActiveSync, ActiveX, Ask Maxwell, Authenticode, AutoSum, BackOffice, the BackOffice logo, bCentral, BizTalk, Bookshelf, ClearType, CodeView, DataTips, Developer Studio, Direct3D, DirectAnimation, DirectDraw, DirectInput, DirectX, DirectXJ, DoubleSpace, DriveSpace, FrontPage, Funstone, Genuine Microsoft Products logo, IntelliEye, the IntelliEye logo, IntelliMirror, IntelliSense, J/Direct, JScript, LineShare, Liquid Motion, Mapbase, MapManager, MapPoint, MapVision, Microsoft Agent logo, the Microsoft eMbedded Visual Tools logo, the Microsoft Internet Explorer logo, the Microsoft Office Compatible logo, Microsoft Press, the Microsoft Press logo, Microsoft QuickBasic, MS-DOS, MSDN, NetMeeting, NetShow, the Office logo, Outlook, PhotoDraw, PivotChart, PivotTable, PowerPoint, QuickAssembler, QuickShelf, RelayOne, Rushmore, SharePoint, SourceSafe, TipWizard, V-Chat, VideoFlash, Virtual Basic, the Virtual Basic logo, Visual C++, Visual C#, Visual FoxPro, Visual InterDev, Visual J++, Visual SourceSafe, Visual Studio, the Visual Studio logo, Vizact, WebBot, WebPIP, Win32, Win32s, Win64, Windows, the Windows CE logo, the Windows logo, Windows NT, the Windows Start logo, and XENIX, among others, are either trademarks or registered trademarks of Microsoft Corporation in the United States and/or in other countries.

Sun, Sun Microsystems, the Sun Logo, Ultra, AnswerBook 2, medialib, OpenBoot, Solaris, Java, Java 3D, ShowMe TV, SunForum, SunVTS, SunFDDI, StarOffice, and SunPCi, among others, are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries

J-Integra is a trademark of Intrinsync Software, Inc.

Design Patterns: Elements of Reusable Object-Oriented Software, by Erich Gamma, Richard Helm, Ralph Johnson and John Vlissides. Copyright © 1995 by Addison-Wesley Publishing Company, Inc. All rights reserved.

THIRD PARTY CODE, THIRD PARTY LICENSES, AND ACKNOWLEDGEMENTS

Note that in the text below, "Program" refers to Rational® XDE™ software and associated documentation.The Program is composed of multiple separately written and copyrighted modular software components. Some of the components are provided under separate, non-Rational licenses that permit copying, modification and redistribution of those components. Such components are licensed pursuant to the terms of the available license. The components and applicable license terms are set forth below.

I. ComponentOne VSFlexGrid

II. Intrinsync Software J-Integra

This product includes J-Integra software developed by Intrinsync Software Inc. J-Integra is a trademark of Intrinsync Software, Inc.

III. Rhino JavaScript 1.5R1

The Program is accompanied by software developed by Mozilla as part of the Rhino project. The Rhino code included with the Program in XDE\hshell\plugins\com.rational.hshell.ratltool\js.jar or XDE\JavaScriptPkg\js.jar includes modifications necessary to embed the scripting engine with the Program. The source code corresponding to these modifications can be found in the directory "XDE\License Information\Rhino". Your use of Rhino in binary code form accompanying the Program is subject to the terms and conditions of the Netscape Public License Version 1.1 which is found at "XDE\License Information\Rhino\NetscapePublicLicense-1.1.html" and on the Internet at (http://www.mozilla.org/MPL/NPL-1.1.html). Source code for Rhino is available at (http://www.mozilla.org/rhino/) under the terms of the Netscape Public License 1.1.

IV. mpack/munpack

The Program is accompanied by software developed by Carnegie Mellon University. The mpack code included with the Program includes minor modifications. The source code corresponding to these modifications can be found in the directory "XDE\License Information\mpack". Your use of mpack in binary code form accompanying the Program is subject to the terms and conditions of the license that is found at "XDE\License Information\mpack\mpack_license.txt". Specifically, mpack is:

(C) Copyright 1993,1994 by Carnegie Mellon University All Rights Reserved.

Permission to use, copy, modify, distribute, and sell this software

and its documentation for any purpose is hereby granted without fee,

provided that the above copyright notice appear in all copies and that

both that copyright notice and this permission notice appear in

supporting documentation, and that the name of Carnegie Mellon

University not be used in advertising or publicity pertaining to

distribution of the software without specific, written prior

permission.  Carnegie Mellon University makes no representations about

the suitability of this software for any purpose.  It is provided "as

is" without express or implied warranty.

CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO

THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY

AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE

FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES

WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN

AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING

OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS

SOFTWARE.

Portions of this software are derived from code written by Bell

Communications Research, Inc. (Bellcore) and by RSA Data Security,

Inc. and bear similar copyrights and disclaimers of warranty.

V. Expat 1.0.2

The Program is accompanied by software developed by James Clark. The Expat code included with the Program includes minor modifications. The modifications can be found in the directory "XDE\License Information\Expat". Your use of Expat in binary code form accompanying the Program is subject to the terms and conditions of the Mozilla Public License 1.0 which is found at "XDE\License Information\Expat\MozillaPublicLicense-1.0.html" and on the Internet at (http://www.mozilla.org/MPL/MPL-1.0.html). Source code for Expat is available from (http://www.jclark.com/xml) under the terms of the Mozilla Public License.

VI. Xerces-J 1.4.4 and Xalan 1.2

The Program is accompanied by software developed by The Apache Software Foundation as part of the Apache XML project. The Xerces code included with the Program in XDE\hshell\plugins\org.apache.xerces\xerces.jar (or XDE\AddIns\common) includes no modifications. Your use of Xerces in binary code form accompanying the Program is subject to the terms and conditions of the Apache Software License 1.1 which is found at "XDE\License Information\Xalan-Xerces\ApacheSoftwareLicense-1.1.txt" and on the Internet at http://xml.apache.org/LICENSE. Specifically, Xerces is:

 * Copyright (c) 1999 The Apache Software Foundation.  All rights

 * reserved.

 * Redistribution and use in source and binary forms, with or without

 * modification, are permitted provided that the following conditions

 * are met:

 * 1. Redistributions of source code must retain the above copyright

 *    notice, this list of conditions and the following disclaimer.

 * 2. Redistributions in binary form must reproduce the above copyright

 *    notice, this list of conditions and the following disclaimer in

 *    the documentation and/or other materials provided with the

 *    distribution.

 * 3. The end-user documentation included with the redistribution,

 *    if any, must include the following acknowledgment:

 *       "This product includes software developed by the

 *        Apache Software Foundation (http://www.apache.org/)."

 *    Alternately, this acknowledgment may appear in the software itself,

 *    if and wherever such third-party acknowledgments normally appear.

 * 4. The names "Xerces" and "Apache Software Foundation" must

 *    not be used to endorse or promote products derived from this

 *    software without prior written permission. For written

 *    permission, please contact apache@apache.org.

 * 5. Products derived from this software may not be called "Apache",

 *    nor may "Apache" appear in their name, without prior written

 *    permission of the Apache Software Foundation.

   THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR

   IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED

   WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

   ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR

   ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,

   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT

   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,

   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY

   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE

   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

   This software consists of voluntary contributions made by many

   individuals on behalf of the Apache Software Foundation. For more

   information on the Apache Software Foundation, please see http://www.apache.org/.

VII. LEAD Technologies LEADTOOLS

VIII. Regex

IX. Summit BasicScript

PATENTS

Portions covered by U.S. Patent Nos. 5,193,180 and 5,335,334 and 5,535,329 and 5,574,898 and 5,649,200 and 5,675,802 and 5,754,760 and 5,835,701 and 6,049,666 and 6,126,329 and 6,167,534 and 6,206,584. U.S. Patents Pending. International Patents Pending.

Purify is licensed under Sun Microsystems, Inc., U.S. Patent No. 5,404,499.

GOVERNMENT RIGHTS LEGEND

Use, duplication, or disclosure by the U.S. Government is subject to restrictions set forth in the applicable Rational Software Corporation license agreement and as provided in DFARS 277.7202-1(a) and 277.7202-3(a) (1995), DFARS 252.227-7013(c)(1)(ii) (Oct. 1988), FAR 12.212(a) (1995), FAR 52.227-19, or FAR 227-14, as applicable.

WARRANTY DISCLAIMER

This document and its associated software may be used as stated in the underlying license agreement. Rational Software Corporation expressly disclaims all other warranties, express or implied, with respect to the media and software product and its documentation, including without limitation, the warranties of merchantability or fitness for a particular purpose or arising from a course of dealing, usage, or trade practice.