Rational^® XDE^TM - .NET Edition

Release Notes

Version 2002 Release 2

Part Number: 800-025696-000

Copyright

Copyright ©2002, Rational Software Corporation. All rights reserved.

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.

Legal Notices

About this Document

The Rational XDE Release Notes contains important information you will need to install and use Rational XDE - .NET Edition. It is important to review this document because it describes: 

• What to do before you start installation 
• How to install
• How to start Rational XDE and create a new model
• How to open your existing models, and the compatibility issues that affect how your models appear and work
• Known problems that you may encounter
• How to contact technical support

Note: The printed version of this document does not include the listing of Known Issues. In order to provide the most up-to-date information possible at release time, this information is included only in the online version of the Rational XDE Release Notes. The online version is installed with the Rational XDE product, and you can also access it directly from your product CD. In addition, to be sure that you have the absolute latest available information, we recommend that you download the Rational XDE Release Notes from http://www.rational.net/XDEcenter.

Contents

About this Document

Welcome to Rational XDE

Joining the Rational Developer Network

What Is the Rational Developer Network? 

How to Register

What's New in This Release

Hardware and Software Guidelines

Hardware Guidelines

Software Guidelines

Rational XDE Packaging and Features

Packaging Information

Visual Modeling Features

Data Modeling Features

Team Development and Configuration Management Features 

Web Publishing and Reporting Features

Visual C# Modeling and Round-Trip Engineering Features

Development Accelerators 

Integrated Use Case Management

RUP Configuration for .NET Developers

Getting Help and More Information

Compatibility Issues

Rational Administrator and Rational Rose

Rational XDE with Rational RequisitePro

Rational XDE with Rational ClearCase

Installing and Uninstalling Rational XDE

Installation Issues

Installing Rational XDE

Uninstalling Rational XDE

Getting Started with Rational XDE

Starting Rational XDE

Using the Getting Started Model

Creating a New Model in an Existing Project

Creating a New Model of a Visual C# Project

Understanding Rational XDE Tool Windows

Upgrading and Migrating Models to Rational XDE v2002 Release 2

Frequently Asked Questions (FAQ)

Restrictions and Guidelines

General

Cut/Copy/Paste Behavior

Sequence Diagrams

UML Interfaces 

Development Accelerators

Web Publishing and Reporting

Configuration Management

Compare and Merge 

Visual C# Round-Trip Engineering

Sharing Models through E-mail

Known Rational XDE Issues

Issues Fixed in This Release

Contacting Rational Technical Support

Welcome to Rational XDE

We at Rational Software believe that this release is the beginning of a new and vital chapter in rapid application development and visual modeling. You now have one of the most powerful tools for designing, communicating, and documenting all phases of software development integrated with the same tools you use to develop the applications and systems you build. This is seamless integration at its best.  Whether you work within highly structured processes and require durable, long-lived models, or you are an extreme programmer and modeler using lightweight, disposable models, this is the tool flexible enough, intuitive enough, scalable enough, and synchronized enough to become an indispensable part of what you do.

Rational XDE lets you build a rich, highly scalable semantic representation of your entire system, from system architecture to its static and dynamic structure. Plus it's completely integrated with the tools you use to edit, debug, and test. Automatic synchronization of your system’s model and code means you are always able to see and understand the solution you're developing without forcing you to focus on the tools you're using. What’s more, Rational XDE fully leverages the effort you put into modeling your architecture and design because it can generate large portions of your application through automatic pattern expansion and Rational Development Accelerators™. If you do not already have an architectural model, Rational XDE can reverse engineer your existing application into a rich, visual model, allowing you to understand and modify your system at any level of abstraction or detail you choose.

So thank you for joining us. We are confident you'll not only like what you see, but what you can do.

Back to Contents

Joining the Rational Developer Network

What is the Rational Developer Network?

The Rational Developer Network is a Web site that extends the reach of your development team with the expertise of an online community, providing practical information and a forum for exchanging ideas and best practices. This site benefits you and your team by helping you to:

• Find the answers to specific technical questions
• Learn new tools and methodologies and apply them to your specific technology domain
• Discover new ways to handle changes in project definition and technology

Available 24x7, this Web site aggregates articles, book excerpts, scripts, hooks, triggers, models, plug-ins, patches, and other artifacts that help you use the Rational tools in your project environment. Content is updated weekly and is created by Rational experts, customers, and partners such as the IEEE Computer Society and Addison-Wesley. By participating in online discussions, you can connect with development professionals all over the world and leverage their experience. Also, you can access quality Web-based training on concepts and tools by Rational University or technical training by our partner Digital Think.

With the exception of Web-based training, all of these resources are available to you and each member of your team, at no cost, as a part of your active maintenance agreement. For more information about the Rational Developer Network, visit http://www.rational.com/services/rdn.  

How to Register

It's easy to register. Simply visit http://www.rational.net/register, enter your account number, and set up a username and password. You can find your account number on the shipping information and invoices that were sent to you. If you have trouble finding your account number, call Technical Support Licensing at (800) 433-5444, Option 3. Please have your sales order number, PO number, or host ID available for authentication purposes.

Back to Contents

What's New in This Release 

Frictionless Design and Development 

• No extra steps to install Integrated Use Case Management (RequisitePro/XDE integration).
• Access RUP Configurations without a network connection.
• Now runs on Windows NT.

Unleash the Power of Your Patterns

• Faster and improved pattern application.
• Organize Favorites -- Use the Tools menu to maintain a list of your most frequently used patterns.
• Apply Favorite  -- Use a shortcut menu or the Tools menu to access your list of favorites.
• Apply Recent -- Use a shortcut menu to access your list of previously applied patterns, in most-recently-used-first order.
• Apply Patterns -- Use a shortcut menu to apply patterns to a class, automatically selecting the target class as input.

Instant UML/Assisted Modeling

• Code Properties tool window -- Shows you UML model properties in the vocabulary of C#, making it easier for C# developers to design software using UML.
• C# Toolbox tab -- New C# tab lets you drag the most frequently used C# constructs onto your diagrams.
• Assisted Modeling wizards -- Appear automatically when you drag a property, delegate, or event from the Modeling Toolbox, helping you model these constructs using C# terms and concepts.
• Model Overview diagram -- Provides a formatted overview of a model, showing inheritance relationships with the click of a button.

Data Modeling

• Provides visual modeling of database designs.
• Provides one language and one tool so that data modelers, developers, and business analysts can work together. 
• Allows easy sharing of database designs among developers and other team members.
• Facilitates model and diagram creation at any level of abstraction. 

Web Publishing and Reporting

• Publish models, diagrams, and model element properties to the Web.
• Interactively browse model in tree view or data view.
• Create HTML -format models that can be viewed with only a Web browser. 
• Generate reports by extracting information from models, including diagrams.

Enhanced Internationalization Support

• Level 1 compliance for the following languages when installed on native operating systems: Dutch, Hebrew, Traditional Chinese, and Korean. 
• Level 2 compliance for the following languages when installed on native operating systems: German, French, Italian, Swedish, Japanese, and Simplified Chinese. (Supports local character set or English in fields, forms and documents; supports locale-specific conventions for date/time formats, numbering, and currency.)

Back to Contents

Hardware and Software Guidelines

Hardware Guidelines

The following table provides minimum and recommended system configuration requirements for Rational XDE. 

Keep in mind that performance has been tuned for the recommended system configuration. In general, increasing available memory (by adding more memory or closing other applications) increases performance, especially when working with large models. 

Also note that the disk space required by your Rational XDE workspaces varies significantly, depending on the size and number of files you create. Rational XDE model files for analysis may be quite small, whereas model files for enterprise-level development may grow to be quite large, particularly when generated code is included in the calculation.

Rational XDE runs under the minimum configuration; however enterprise-level development is enhanced when resources conform to the recommended configuration.

Back to Contents

Software Guidelines

Back to Contents

Rational XDE Packaging and Features

Packaging Information

Rational XDE v2002 Release 2 is available in several packaging options for use with Microsoft Visual Studio .NET:

• Rational XDE Modeler v2002 Release 2 - .NET Edition, which provides visual modeling, team development and configuration management, development accelerators, and Web publishing and reporting capabilities
• Rational XDE Professional v2002 Release 2 - .NET Edition, which provides everything in Rational XDE Modeler, plus data modeling and  Visual C# modeling and round-trip engineering capabilities.

Notes: 

• A Professional Plus package is also available, which includes both Rational XDE Professional v2002 Release 2 - .NET Edition (for Microsoft Visual Studio .NET) and Rational XDE Professional v2002 Release 2 - Java Platform Edition (standalone and WSS AD).
• The entire Rational XDE online Help system is installed with all Rational XDE packages. You will find information about capabilities such as data modeling and round-trip engineering, even though they may not be available with your current package.

Back to Contents

Visual Modeling Features

Rational XDE empowers you to create comprehensive, flexible UML models from within a world-class integrated development environment.

• Create comprehensive models of your software architecture with the standard UML diagrams: Class, Use Case, Activity, Statechart, Sequence, Component, and Deployment:
• Graphically represent your software and systems without the tight constraints of strongly typed diagrams.
• Drop shapes and connectors onto diagrams using the Visual Studio .NET standard toolbox mechanism, tailored for UML and organized by diagram type.
• Edit and format diagrams with precise control over alignment, spacing, sizing, grouping, and front/back order (z-order). Rearrange views and elements with standard cut/copy/paste and drag-and-drop gestures.
• Navigate diagrams using diagram tabs, zooming, and the thumbnail diagram navigation tool.
• Model fearlessly with a reliable multi-level undo/redo capability.
• Easily inspect or modify the properties of one or multiple elements using the active selection-based Properties window.
• Manage multiple views of complex models without getting lost. Rational XDE can query models for elements related to the current selection, as well as find and replace model element names.
• Model and leverage design patterns with parameterized collaborations that specify structure and interactions.
• Validate whole or selected elements for compliance to UML guidelines for good models.
• View and manipulate model elements and their containment hierarchy using the Model Explorer. Apply persistent sort order and presentation filters that allow you to show only the element kinds of interest.
• Partition the representation of your architecture into multiple models. Work with multiple models simultaneously, creating inter-model views and relationships.
• Enable team development by controlling fine-grained model subunits (for example, class-level subunits) using the Visual Studio .NET configuration management system integration. The Model Explorer shows the controlled status of units and, if you choose, will prompt you to check-out controlled units at the time they are modified.

Back to Contents

Data Modeling Features

Rational XDE provides data modeling features that allow you to build, model, and design your database, and map it to your application and architectural models. Having all of your information in one place and one language helps to open up the lines of communication across teams and enables them to build applications that map directly to the database. With Rational XDE, you can model your database from scratch and generate the database based on the model, reverse engineer an existing database into a data model, or compare and synchronize your data model with your existing database.

Rational XDE data modeling capabilities support the following databases:

• Oracle 7.x, 8.x and 9i 
• MS SQL Server 7.x and 2000 
• DB2 UDB 5.x, 6.x and 7.x 
• DB2/MVS 5.x and 6.x  (including tablespace Roundtrip engineering in DDL)
• Sybase System 12

Back to Contents

Team Development and Configuration Management Features

Rational XDE works in conjunction with supported configuration management software to provide source control, versioning, and backup capabilities. (See Hardware and Software Guidelines for information on supported configuration management software.)

You can divide models into multiple files (called storage units) to make it easier to work with large models, as well as to facilitate working with teams and configuration management systems. On-demand storage unit loading lets you access model elements without knowing whether they are currently loaded; the unit simply loads automatically when you access an element that requires it.

The following model elements can be made into storage units on their own or in combination with other model elements:

• Activity Graph
• Actor
• Class
• Collaboration
• Collaboration Instance
• Component
• Component Instance
• Diagram
• Enumeration
• Interaction
• Interaction Instance
• Interface
• Node
• Node Instance
• Object
• Package
• Signal
• State Machine
• Subsystem
• Use-Case

Using Rational XDE compare and merge capabilities, you can view the differences and conflicts among model or storage unit files, manually or automatically resolve conflicts, and then merge the files to produce a single output model. This becomes especially important when your team development workflows allow more that one person to work on the same controlled units at the same time.

Back to Contents

Web Publishing and Reporting Features

Rational XDE provides web publishing capabilities that let you create and publish a navigable, HTML-based view of your model and generate various types of reports in HTML format. 

A published model is a portable snapshot of a model that you can view, share, and navigate using your preferred web browser. You can also choose from a number of out-of-the-box, pre-defined report templates to generate HTML-based reports, including:

• Summary Classifier Report
• Summary Classifier and Diagram Report
• Detailed Class Report
• Detailed Use Case Report

These Web publishing and reporting features let you easily share information across roles and organizations, without requiring stakeholders to have Rational XDE on their desktops.

Back to Contents

Visual C# Modeling and Round-trip Engineering Features

Rational XDE provides fully integrated Visual C# round-trip engineering capabilities in the Microsoft Visual Studio .NET environment. This includes code generation, reverse engineering, and automatic round-trip engineering, all of which are accessible from the Solution Explorer, the Class View, the XDE Model Explorer, and XDE diagrams. 

• Edit UML diagrams in the Visual Studio .NET document window.
• Use split windows to view the code and diagram at the same time.
• Dock, undock, and resize the UML Model Explorer and UML Documentation windows.
• Use the prebuilt UML models of Visual Studio .NET framework assemblies, which are included with Rational XDE.
• Automatically reverse engineer UML models of assemblies referenced by your projects, and add them to your solution.

Back to Contents

Development Accelerators

Rational XDE includes support for patterns and code templates, the key building blocks for software development accelerators. Fully integrated and traceable pattern support lets you create, capture, package, apply, and re-apply design patterns. Perhaps the most important pattern-support feature is UML-to-UML transformation, which allows you to add new UML elements to a model, as well as modify existing UML elements in a model. 

In addition, you can easily specify your own patterns using the Patterns Toolkit, which provides everything you need to find, create, edit, apply, and document patterns in your model. The Patterns Toolkit includes:

• Pattern Application Wizard with step-by-step guidance for applying a pattern
• Pattern Explorer to find, create, edit, and apply patterns
• Pattern Import/Export wizards that comply with the Reusable Asset Specification (RAS) and that generate HTML-based pattern documentation

Using these tools, patterns content providers can create patterns that:

• Are language-, platform-, and domain-specific
• Implement custom application wizard dialog boxes
• Incorporate pattern-specific documentation
• Are packaged for distribution (RAS-compliant)

Code template support lets you automatically generate code for operation bodies, which is a manual process in tools other than Rational XDE. Code templates automate the tedious tasks of writing and rewriting the same code multiple times. In addition, code templates are integrated with patterns, and can be customized with parameters or scripts. You can even apply patterns that attach code templates to any pattern-created or pattern-modified element in your model.

Back to Contents

Integrated Use Case Management

Integrated Use Case Management enhances the comprehensive capabilities of Rational XDE use-case modeling with the powerful requirements management capabilities in Rational RequisitePro. This integration lets you associate your Rational XDE model and its use cases to requirements in a RequisitePro project.

For information on starting and using Rational XDE with the Rational RequisitePro integration, see Rational XDE with Rational RequisitePro in the Compatibility section of the Release Notes. 

For more information, see the Integrated Use Case Management topic, which is in the Working with Use-Case Diagrams Help book in the Rational XDE Help, or open the Integration Use Case Management Help, which is located on the Tools > Rational RequisitePro menu.

Back to Contents

RUP Configuration for .NET Developers

When you purchase Rational XDE v2002 Release 2, you also receive RUP Configuration for Microsoft .NET Developers (RCND). 

The Rational Unified Process, or RUP, product is a software engineering process. It provides a disciplined approach to assigning tasks and responsibilities within a development organization. Its goal is to ensure the production of high-quality software that meets the needs of its end users within a predictable schedule and budget. 

RCND is a straightforward, lightweight process configuration of the Rational Unified Process (RUP) that has been specifically customized to address the needs of software developers. It provides guidance to architects and developers on the essential requirements, analysis and design, and implementation activities. The goal of the RCND is to provide a repeatable process to enable software developers to develop high-quality applications faster, more reliably, and more consistently. 

For more information on RCND, check the Release Notes in xdeinstalldir\RationalUnifiedProcess.rcnd\Readme_First.html.

Back to Contents

Getting Help and More Information

In addition to the Rational XDE Release Notes, you will find complete documentation for Rational XDE .NET Edition in the form of fully integrated online Help, including context-sensitive Help.

To access Rational XDE online Help, do one of the following:

• Click Help > Contents > Rational XDE and expand the Contents hierarchy to access the complete online Help system. 
• Click Help > Search to find any term or topic in the Help system.

You can also access links to additional XDE Resources, including the Rational Developer Network, XDE Knowledge Center (which includes links to the latest Release Notes), the XDE Tutorial, and other information. Access these XDE Resources in one of the following ways:

• Search for the Rational XDE Resources Help topic:

1. Click Help > Search.
2. Look for Rational XDE Resources.

• Find the topic in the online Help Table of Contents:

1. Access the Rational XDE Help book.
2. Expand the Modeling with Rational XDE Software book.
3. Click the Rational XDE Resources topic and follow the links to the resources you want.

Note: Indexing and filtering capabilities for Rational XDE Help have been added to this release.

Back to Contents

Compatibility Issues

Rational Administrator and Rational Rose

If you have used the Rational Administrator to set up a Rational project that includes Rational Rose models, and you subsequently migrate your Rose models to Rational XDE, the Rational project in the Administrator will continue to show your registered project as containing the Rose models, even though they have become obsolete. See Migrating Rational Rose Models into Rational XDE for more information on Rational Rose to Rational XDE migration.

Rational XDE with Rational RequisitePro (Integrated Use Case Management) 

For each model with which you intend to use this integration, you must set the model's AppliedProfiles property to RequisitePro:

1. In the Model Explorer, select the model.
2. In the Properties pane, type RequisitePro in the AppliedProfiles property.

Setting the AppliedProfiles property automatically creates the necessary default packages in the model (Component View, Deployment View, Logical View, Use Case View) and also adds the Rational RequisitePro integration to the Rational XDE Tools menu.

To start the Rational RequisitePro/XDE integration, which lets you associate your model and its use cases to requirements in a RequisitePro project, click Tools > Rational RequisitePro in Rational XDE. 

Back to Contents

Rational XDE with Rational ClearCase

Setting ClearCase Options

When running Rational XDE with Rational ClearCase, activating the options described in the following table is recommended. To access these options, click Tools > Options; then, in the Options dialog box, click Source Control > SCC Provider, and then click Advanced...

Working with Multiple Snapshot Views

If you are using ClearCase 4.2 or ClearCase LT v.2001A.04.00 and you have more than one snapshot view open on the same stream, then the changes you make to the stream in one view will not be seen in the other views unless you update those other views as well.

Comparing and Merging Rational XDE Models Using Rational ClearCase

To be able to compare and merge Rational XDE model and subunit files directly in Rational ClearCase, you must configure Rational XDE as a ClearCase type manager. For instructions, see the Rational XDE online Help  topic, Configuring XDE as the ClearCase Type Manager. 

Back to Contents

Installing and Uninstalling Rational XDE

Installation Issues

• If you are installing Rational XDE over Microsoft Visual Studio .NET 7.0 with VSIP, you must install Rational XDE before installing VSIP. Otherwise, Rational XDE will not be accessible to all instances of Visual Studio .NET 7.0 on your system.
• If you have any other Rational products installed on your system, the installation program will automatically install Rational XDE to the same directory as these other Rational products. 
• Do not install Rational XDE in a directory with double-byte or extended characters in the path (for example, using Japanese characters). The product will not function if installed in this way.
• If you install more than one version of Rational XDE on the same system, you cannot open model files from Windows Explorer; you will have to open them from within Rational XDE.
• Due to the installation image's large zip files, Rational recommends temporarily disabling the active scanning feature of your anti-virus software prior to installation. If you do not disable this feature, the installation could remain in an incomplete state.
• Rational XDE uses a Java – COM bridge software package called J-Integra. If your path contains multiple entries for J-Integra because of other software you have installed on your computer, you must ensure that the one installed with Rational XDE is first in your path. If the path entries are not successfully added to your system path during installation or another installation of J-Integra is referenced first on your system path, Rational XDE will not run.
• Because of the deep product directory structure, the length of the base installation path (default = C:\Program Files\Rational) must not exceed 60 characters; otherwise the installation may not work properly. This is because the full path plus file name length of some files will exceed the 255-character limit for Windows.
• During installation, entries are added to the Path system environment variable. If there are already many entries in the path, these additions may cause the path to exceed the Windows maximum for this variable. You will receive an error at the end of install regarding REGSVR32.EXE, which indicates the failure of some dll's to register. Rational XDE will not function correctly if this happens and you must uninstall, eliminate some entries from your Path environment variable, and then reinstall Rational XDE.
• If you have a beta version of Rational XDE on your system, be sure to follow the steps for Uninstalling Rational XDE before installing the released version of Rational XDE.
• Do not attempt to install Rational XDE while a version of Rational XDE is running; otherwise, installation errors can occur due to files being locked while the application is running.
• The Software Guidelines in this document list the supported operating systems and platform requirements for Rational XDE. All other operating systems and platforms (including earlier service packs) are untested and unsupported. We believe that Rational XDE will run correctly on Server versions of the supported operating systems; however, these platforms remain untested and unsupported. We believe that Rational XDE will NOT install and run correctly on any version of Windows 95, Windows 98, and Windows ME. Attempting to install on any of these platforms is definitely not recommended.
  
  As part of the installation process, the Rational XDE installation program checks that your operating system is on the list of supported operating systems and also checks that you have the appropriate version of Visual Studio .NET, including service packs. Normally, if your system does not have the required characteristics, installation will not continue. If you need to bypass these installation checks, you can do so, by using regedit or a similar tool to create the following registry keys. Please note that installation to untested or unsupported environments is at your own risk.

• To bypass operating system checking : HKEY_LOCAL_MACHINE\Software\Rational Software\RSSetup\OsCheck
• To bypass Visual Studio .NET version checking: HKEY_LOCAL_MACHINE\Software\Rational Software\RSSetup\IdeCheck

Back to Contents

Installing Rational XDE

Follow these steps to download and install Rational XDE,

1. Close all applications that are running, especially any version of Rational XDE.
2. Ensure that you have administrator privileges on the system where you are installing Rational XDE. You will not be able to complete installation if you are logged in with a userid that does not have full administrative access.
3. Load the Rational XDE product CD.
4. Locate, then double-click setup.exe to begin installation.
5. Click Next when alerted to close all applications.
6. In the Choose Product dialog box, click the product to install, and then click Next.
7. Read the License Agreement and indicate acceptance using the appropriate option button.
8. Click Next to continue or Cancel, if you do not accept the terms of the agreement.
9. From Select Configuration, accept the default Typical configuration and installation location.
10. Acknowledge the installation by clicking Next in the Confirmation dialog box. 
    Installation continues until all files and components have been registered and copied to your system, and an Error Summary lists any errors encountered during installation.
    Note: Rational XDE online Help is installed as the last step in the installation process. The process may seem to stop for up to 2 minutes while this is happening. 
11. If you are prompted to do so, restart Windows and log in again as administrator to complete the installation.

Back to Contents

Uninstalling Rational XDE

You can uninstall Rational XDE by completing a conventional uninstall through Add/Remove Programs in Control Panel. Alternatively, use the following procedure:

1. Click Start > Programs > Rational XDE > Rational Software Installed Product Information.
2. From the list of installed software, select Rational XDE and click Add/Remove.
3. From the Add/Remove dialog box, select Rational XDE and click Change/Remove.

The Rational Installer does not remove files that have been created or modified since the installation of the product. There are two directories of particular interest where these files may reside: 

• installdir\Rational\XDE
• SystemDrive:\Documents and Settings\user\ApplicationData\Rational\XDE

Where:

• installdir is the root directory where you installed Rational XDE (typically C:\Program Files)
• SystemDrive is the Windows system drive for the system on which you installed Rational XDE (typically C:\)
• user is the logon name of the Rational XDE user
• ApplicationData is the directory where your operating system saves user-specific application files and settings

If you uninstall Rational XDE, we recommend that, prior to re-installing Rational XDE, you either rename or delete these directories, which may be left behind after uninstall. Do not delete the directories without first ensuring that any user-created files are backed up, as needed. In addition, if more than one user has used this installation of Rational XDE, you should clean up each user's application data.

Back to Contents

Getting Started with Rational XDE

Starting Rational XDE

Rational XDE is fully integrated with Visual Studio .NET. To start Rational XDE, simply start Visual Studio .NET.

Using the Getting Started Model

The Getting Started model, installed with Rational XDE, is a model template that can help you begin modeling quickly by providing a model structure that conforms to industry best practices. You can add, remove, or rearrange model elements as required for your application. 

The Getting Started model includes separate packages for modeling your system's use cases, design, and deployment. As you become familiar with Rational XDE, you will discover that Rational XDE supports multiple models. You may choose to maintain separate physical models for use cases, design, and deployment, rather than using the packages provided in the model template. In addition, if you are an application developer, you will want to maintain multiple code models, which maintain an implementation-level view of your system and keep your code and models synchronized automatically.

Follow these steps to create and open a new instance of the Getting Started model:

1. Click File > New > File.
2. Click Rational XDE in the left pane, click Getting Started in the right pane, and then click Open.
3. Click File > Save Modeln As... to save the new instance of the model.  
4. Type the name for the model, and save it in an appropriate project folder.

Back to Contents

Creating a New Model in an Existing Project

Once installation is complete, Rational XDE is fully integrated in the Visual Studio .NET environment, and you are ready to create a new model and familiarize yourself with the many features that Rational XDE provides.

Models are stored in files that you manage just as you manage any files in Visual Studio .NET. You can add new or existing model files to your solutions and projects. To create a new model file in an existing project:

1. Right-click a solution or a project in the Solution Explorer.
2. Click Add > Add New Item. 
3. From the Add New Item dialog box, click the Rational XDE folder in the Categories list, and select Blank Model or Getting Started as the Template.
4. You can add existing models to your solution and projects by using Add > Add Existing Item.

Back to Contents

Creating a New Model of a Visual C# Project

Follow these steps to create a model of the code in an existing Visual C# project:

1. From the Solution Explorer, select a Visual C# project in the Solution Explorer
2. Right-click the project name and click Synchronize. Rational XDE creates a model of the Visual C# project.

The name of the model is the same as the name of the project and will typically contain two top-level UML packages; that is, one package with the same name as the project and stereotyped as <<namespace>>, and the other package named Artifacts. You use this model to round-trip engineer your project.  Any new classes that are added to your code are also added to the model when you synchronize the project. Conversely, any new UML classes that are added to the model are also added to the code as a result of synchronization. Classes are generated in the namespace that corresponds to the UML <<namespace>> package that contains the class.

Back to Contents

Understanding Rational XDE Tool Windows

Rational XDE adds the following windows to the Visual Studio .NET shell:

• Model Explorer. This window gives you a hierarchical tree view of all of your open UML model files. The Model Explorer enables you to navigate across UML relationships. If you have a model of a Visual C# code project, the Model Explorer will let you click on a UML item and navigate to the code that implements that item.
• Model Documentation. This window lets you examine and edit the documentation for any UML item that is selected in a diagram or the Model Explorer.
• Code Properties. This window displays editable, language-centric properties of selected model elements. The Code Properties window is activated by right-clicking an element in a model and then clicking Code Properties. The properties displayed in the Code Properties window depend on the Kind, Language, and Stereotype of the selected model element. If an element is in a model that has the .NET profile applied, but does not have a language stereotype, then the element is displayed in Visual C# format.

 These tool windows are fully sizeable and dockable within Visual Studio .NET. You access these windows by clicking View > Other Windows.

Back to Contents

Upgrading and Migrating Models to Rational XDE v2002 Release 2

Upgrading Models to Rational XDE v2002 Release 2

Rational XDE v2002 Release 2 is compatible with models created in Rational XDE v2002. This means that models and files created in Rational XDE v2002 can be viewed and edited in Rational XDE v2002 Release 2. However, before you view and edit a model in Rational XDE v2002 Release 2 that was created in Rational XDE v2002, the model file and all related model files must go through an automatic model conversion process. 

Important:  The automatic model conversion process allows you to save backup copies of your Rational XDE v2002 models before you upgrade. This is highly recommended because Rational XDE v2002 Release 2 models are not downward compatible with Rational XDE v2002. Once a model is upgraded to Rational XDE v2002 Release 2, it cannot be opened in Rational XDE v2002. 

Migrating Rational Rose Models into Rational XDE

You can convert existing Rational Rose models (.mdl files) to Rational XDE models by opening them in Rational XDE and saving them to the new model file (.mdx) format. When you do this, almost all basic model elements and characteristics are converted to Rational XDE equivalents. For example, most of the properties and settings that appear in Rational Rose specifications have similar properties or tagged values in Rational XDE that you can view in the Property Browser. On the other hand, the mapping between C++ or Visual Basic language elements and Rational Rose models are not preserved in Rational XDE.

Notes:

• Always back up your existing model file before beginning any conversion process into Rational XDE.
• The code-specific properties of Rose classes are not converted when you open a Rose model in Rational XDE.
• Collaboration diagrams are not supported in this release. If you convert a Rational Rose model that contains collaboration diagrams, they will not be included in the new XDE model.

Back to Contents

Frequently Asked Questions (FAQ)

Q: I've started Visual Studio .NET. How do I know Rational XDE is installed?

A: In the main menu, click Tools > Options. If Rational XDE is installed, you will see a folder named Rational XDE in the left pane of the options dialog.  Alternatively, on the Windows Start menu, click Programs > Rational XDE Your Edition > Rational Software Installed Product Information. A window appears that shows the versions of all installed Rational products.

Q: How do I get to the XDE modeling functionality?

A: The user interface for XDE modeling can be found in these windows:

• Diagrams: XDE diagrams reside in the .NET document window. This is the same window that displays source code, designers, and other documents. ·
• Toolbox: When a diagram is open in the document window, the .NET Toolbox contains XDE diagramming tools.
• Model Explorer: Similar to the .NET Class View tool window, the Model Explorer displays all of the open XDE models and their contents in a treeview control. You open the Model Explorer by selecting View > Other Windows > Model Explorer
• Model Documentation: The Model Documentation window displays the UML documentation that belongs to the model item selected in a diagram or the Model Explorer. You open the Documentation window by selecting View > Other Windows > Model Documentation.
• Output Window: Informational messages that result from XDE commands are displayed in the standard .NET output window.
• Task List: XDE errors and other items that require user attention appear in the standard .NET task window.

Q: How do I start UML modeling?

A: You begin by creating and adding XDE model files to your .NET solution. Model files, like all files, can be added directly to the solution or to any project in the solution. Once a model file has been added, you can double-click the model file in the Solution Explorer to open it. In the Model Explorer tool window, you can now begin constructing your model by adding UML diagrams, packages, classes, etc. Simply select a model in the Model Explorer, right-click, and then click Add UML and Add Diagram.

Q: How do XDE and my project code work together?

A: Through the process known as synchronization, Rational XDE can synchronize your Visual C# source code with a UML model. (Note that Visual Basic and C++ are not supported in this release.) The steps are simple: In the Solution Explorer, select the project, and then click Synchronize on the Solution Explorer toolbar. Or, you can right-click the project in the Solution Explorer, and then click Synchronize on the shortcut menu. Rational XDE will automatically create a new UML model by the same name as your project. This model will include UML packages that represent the namespaces in your project and UML classes that represent the Visual C# classes in your code.

Q: How are the code changes I make in my project reflected in my models and my diagrams?

A: Simply select the project in the Solution Explorer, then right-click Synchronize.

Q: How do I generate code for a UML class I create in a diagram?

A: The project model described above is the home for all UML items you want to synchronize with your code. Here are the steps:

1. Determine in which Visual C# project you want your class to reside.
2. Use the Synchronize command to create a model for that project (described above).
3. Move your UML class to the package in the project model that represents the target namespace for your class. You can add new namespace packages to the project model by creating UML packages stereotyped as <<namespace>>. 
4. Right-click the class and click Synchronize.

Q: Can there ever be conflicts between the code and my models?

A: Yes. Conflicts may appear in the Visual Studio .NET Task List window as a result of the Synchronize command. Right-click on a conflict task to resolve it. You have two choices:

• Generate Code: This indicates that the model is correct and you want to modify the code to reflect what is in the model.
• Update Model: This indicates that your code is correct and you want to modify the model to reflect what is in the code.

Q: Do I always have to remember to click the Synchronize button?

A: If you always want to keep your model up-to-date with your code, consider enabling the Automatic Synchronization feature. Click Tools > Options > Rational XDE > Round-Trip Engineering and select the Automatic Synchronization checkbox. This dialog box lets you trigger synchronization on File > Save events, or when you change focus between code and model.

Q: Can I navigate back and forth between my code and the UML items that represent the code?

A: Yes. In the Model Explorer, select a model item and right-click Browse Code. This will take you to the code that implements the selected model item. You can also right-click on a declaration in a source code file and click Browse Model. This will take you to the corresponding item in the XDE Model Explorer tool window. Browse Model is also available on nodes in the Visual Studio .NET Class View tool window.

Q: How does XDE work with Visual SourceSafe?

A: An XDE model file is like any other file in the solution. If you add your solution to Visual SourceSafe, your XDE model files are added as well. When you use synchronization, XDE follows all of the source control options that you have set for your solution. To set source control options, click Tools > Options > Source Control.

Note that, in Visual Studio .NET, files that are added to the Miscellaneous Files folder in the solution are never added to source control.

Q: Is there any way to see a model of a .NET assembly created from a C++ .NET or Visual Basic .NET project?

A: Yes. When your Visual C# project references .NET assemblies, synchronizing your Visual C# project will create a shallow model of the binary assemblies that are referenced. These assemblies appear in the Miscellaneous Files folder in the Solution Explorer. Be sure to enable the appearance of this folder by clicking Tools > Options > Environment > Documents,  and then selecting the Show Miscellaneous files in Solution Explorer checkbox. Once you have a shallow reference model, you can make it a deep reference model by right-clicking the reference model in the Model Explorer and clicking Synchronize. You can use classes from reference models on diagrams in your Visual C# model. For example, you can model your Visual C# class so that it inherits from a class in an assembly that was compiled with Visual Basic .NET.

Back to Contents

Restrictions and Guidelines

General

• All storage units must be located within the folder hierarchy associated with the main model file (.mdx).
• When multiple items are selected in a diagram or in the Model Explorer, the Property Browser does not display properties that have enumerated lists.
• You can only apply one profile to any given model. If you want multiple profiles (for example, C# and Data Modeler), you must create separate models for each profile.

Back to Contents

Cut/Copy/Paste Behavior

The results of drag-and-drop and cut/copy/paste actions vary depending on the types of items involved in the original selection and in the target. The results also vary depending on whether or not the target is in the same model as the original selection. As background to understanding these variations, an understanding of the following terminology is helpful: 

• View element versus model element
  A view element is what appears as a shape or connector on a diagram. A model element is the element containing the underlying UML semantics.
• Machine  versus non-machine
  Much of Rational XDE  is free-form. For example, packages can contain a variety of UML model elements and most diagrams can contain a variety of UML shapes. However, UML state machines, activity graphs, and interactions, along with their corresponding diagram types (Statecharts, Activity Graphs, and Sequence Diagrams) are machine-oriented and, as such,  have distinct behavior on a paste or drop action. 
• Shallow versus deep
  In this context, shallow means that only the selected item and its references are affected by the action; deep means that the selected item and some or all of the actual items it references are affected by the action.

Cross-model Considerations

Pasting of view elements is currently disabled; however, you can create a new view element of any model element by dragging the model element from the model explorer onto the diagram surface. 

Intra-model Considerations

• When copying and pasting Statechart and Activity Shapes:
  • If you paste a StateMachine or ActivityGraph shape to the same element from which you copied it, you get new views only.
  • If you paste a StateMachine or ActivityGraph shape to a different StateMachine or ActivityGraph shape, you get new views and new model elements. This is because StateMachines and ActivityGraphs must be self-contained (part of the free-form restrictions).
• When copying and pasting Sequence shapes, you cannot do so from one diagram to another diagram; however, you can paste to another application, such as Microsoft Word.
• When copying and pasting other shapes (for example, class, use case, etc.), you always get new views of the same underlying model elements. The model elements themselves are not pasted.

Back to Contents

Sequence Diagrams

Sequence diagrams behave differently depending on their owner in the model. Sequence diagrams must be owned by an Interaction, which in turn must be owned either by a collaboration or a collaboration instance. Collaborations are role-based, whereas collaboration instances are instance-based or object- based. The simplest way to create a sequence diagram with the required interaction is to do the following:

1. In the Model Explorer, right-click an element, such as a package.
2. Click Add Diagram > Sequence:Instance or Sequence:Role

Note: When a sequence diagram's interaction is owned by a collaboration instance, the lifelines dropped on the drawing surface are objects. 

Another way to create a sequence diagram is to first create a collaboration, then create an Interaction, and finally, create a sequence diagram. At this point, any lifelines dropped on the diagram will be classifier roles.

Back to Contents

UML Interfaces

Back to Contents

Development Accelerators

The Modeler package of Rational XDE includes patterns capabilities, but does not include the GoF patterns. 

To import the GoF/C# pattern model (GoFPatternLibrary.mdx) into your Rational XDE project, click File > Import. This extracts the model from the RAS file (GoF.ras) and places it in the target location of your choice. The model includes attached documentation files that provide background information on the patterns. The imported GoF/C# pattern model is writeable, which means that you can alter the pattern definition for your needs. To restore the model defaults, re-import the RAS file to another location.

Note: In order to preserve the updated links for your chosen target location, be sure to save the model when you first import it.

Back to Contents

Web Publishing and Reporting

Java Plug-in

The web publishing and reporting capabilities in Rational XDE require the Java Plug-in, available from the Sun Web site. This plug-in must be installed on any machine on which you want to view published reports. If you have not already downloaded and installed the plug-in, you are prompted to do so the first time you use a web publishing or reporting capability in Rational XDE.

Note: If your machine is not connected to the internet, you will not be notified about the need for the plug-in, and you will get errors when publishing and reporting.

To download and install the plug-in:

• You must be connected to the internet.
• You must have Administrator rights.
• If you are running on Windows NT, you must close Rational XDE before you can download.
• If you are using a Japanese operating system, you must download the International Version of the plug-in (for Netscape) or select the appropriate Locale (for Internet Explorer).

If you download and install the Java Plug-in version 1.4, you may need to change the default security settings to allow read permission. Follow these steps to change the default security:

1. Locate the .java.policy file in your home directory. Create the file, if it does not exist.
2. Append the following section to the end of the file: 
   
   grant codeBase "file:/-" 
   {
         permission java.io.FilePermission "<<ALL FILES>>", "read"; 
   };
   
3. Save the file.
4. Restart the browser.

Free Disk Space

Because, publishing models requires significant free disk space, use the following guidelines when publishing:

• For a 500 KB model, allow 10 MB of free disk space.
• For a 20 MB model, allow 2 GB of free disk space.

Back to Contents

Configuration Management

Using ClearCase Dynamic Views with Rational XDE

Note: The project location is not fully trusted by the .NET runtime. This is usually because it is either a network share or mapped to a network share on the local machine. If the output path is under the project location, your code will not execute as fully trusted and you may receive unexpected security exceptions.

Partitioning Models into Subunits

Using ClearCase View Servers with Rational XDE

To be able to compare and merge Rational XDE model and subunit files directly in Rational Clearcase, you must configure Rational XDE as a ClearCase type manager. For instructions, see the Rational XDE online Help  topic, Configuring XDE as the ClearCase Type Manager. 

Back to Contents

Compare and Merge

Comparing and Merging Models

If you close Rational XDE while a Merge session is in progress, the Merge session will be terminated without displaying a warning. If all conflicts are resolved, the result will be the same as when ending a Merge session normally. If there are still unresolved conflicts, then the Merge session is abandoned and any intermediate results are discarded.

Comparing and Merging Round-Trip Engineering Projects that Show Unfamiliar Differences or Conflicts

When comparing and merging round-trip engineering projects, you may see differences or conflicts that do not appear to be related to any changes that you have made. These may appear in one or more of the following tagged value overrides (TVOs):

• .Net/RTE Proxy/Ancestor
• .Net/RTE Proxy/AncestorSignature 
• .Net/RTE Proxy/RemovedChildren 
• .Net/RTE Proxy/CodeGUID

The differences and conflicts appear specifically in Value properties in the Comparative Property Explorer. The difference is usually a string value that is interpreted by a programming language round-trip engineering feature that you are using. Although these elements are not visible in the Model Explorer and most likely were not modified by you or your team members, they may have been modified internally, following a modification of round-trip engineering model elements. The round-trip engineering feature specifically recognizes these properties after a merge, and regenerates them as necessary.

You can safely resolve the resulting differences or conflicts by accepting the default resolution provided in a non-conflicting difference, or by resolving conflicts using any of the contributors. To regenerate these by round-trip engineering, always synchronize the project immediately after merging.

Back to Contents

Visual C# Round-Trip Engineering

• Rational XDE is limited to round-trip engineering of Visual C# source code projects.
• There are synchronization issues related to operation parameters. For best results, invoke synchronization after each single operation parameter change.
• Actions in the Model Explorer intended to change the namespace of a Visual C# class during synchronization should be avoided. Instead, change the namespace in the code, and synchronize the model with the code.

Back to Contents

Sharing Models Through E-mail

If you want to share models with others on an informal basis, you can send models through email or place them on a shared directory. This is easy to do, as long as you take proper steps to ensure that the recipient receives all files that are part of the model(s).

Depending on the storage unit policy you have selected, your model can consist of a single file with an .mdx extension, or it may be composed of several files, or storage units. These storage units are located in a directory with the same simple name as the model file. For example, if you have a model called CommunicationLayer, you will have a corresponding model file called CommunicationLayer.mdx. You may also find a folder called CommunicationLayer, containing additional storage units for the model. 

Follow these steps to informally share a model: 

1. Create a folder or ZIP file to contain the model files you will share. A ZIP file is recommended in order to reduce file sizes for email transmission.
2. Locate the .mdx file in the file system and drag the .mdx file's enclosing folder onto the ZIP file icon. 
3. When the Winzip Add dialog box appears, click Add to add the .mdx file to the archive. 
4. If your model contains storage units, drag the folder containing its subunits to the ZIP file and Add them to the archive as well. Note that, if the folder exists, it will have the same name as your model file, but without the .mdx suffix.
5. Ensure that you did not include any Rational XDE index files (.idx file extension) or  .ratl_comp_root files in the zip file.
6. For each additional model that you wish to share, follow steps 2 through 5.
7. Send an email with the ZIP file to the intended recipient.

Upon receiving the ZIP file, do one of the following:

• Unzip the file to a local directory within an existing Rational XDE project
• Unzip the file to any directory, and then create a Rational XDE project at that location. 
• Unzip the file to a local directory, and import the model into an existing XDE project, using File > Import.

Back to Contents

Known Rational XDE Issues

Back to Contents

Issues Fixed in This Release 

Back to Contents

Contacting Rational Technical Support

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

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)

Back to Contents

Legal Notices

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 

VSFlexGrid Pro is a trademark of ComponentOne LLC,Copyright 2001.All rights reserved. 

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

This product includes VSFlexGrid software developed by ComponentOne LLC. VSFlexGrid Pro is a trademark of ComponentOne LLC,Copyright 2001.All rights reserved.

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

Portions of this product were created using LEADTOOLS (c)1991-1999, LEAD Technologies, Inc. ALL RIGHTS RESERVED.

VIII. Regex

This product includes Regex software developed by Dr. John Maddock Copyright (c) 1998-1999.

IX. Summit BasicScript

This product includes BasicScript © 1996-2001, Summit Software Company.

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.