Rational^® XDE^TM - Java Platform and Workbench Edition

Release Notes

Version 2002 Release 2

Part Number: 800-025695-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 - Java Platform 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 modeling project
• 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 Guideline

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

Java, J2EE, and JSP-Based Web Modeling and Round-trip Engineering Features

Development Accelerators

Integrated Use Case Management

RUP Configuration for Java 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 Modeling Project

Upgrading and Migrating Models to Rational XDE v2002 Release 2

Restrictions and Guidelines

General 

Moving and Renaming Model Files

Cut/Copy/Paste Behavior

Sequence Diagrams

UML and Java Interfaces 

Development Accelerators

Web Publishing and Reporting

Configuration Management

Compare and Merge 

Java and Web Modeling

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 like not only 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.
• Transform a class directly to an EJB right on the class diagram.

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 IBM WebSphere technologies:

• Rational XDE Modeler v2002 Release 2, which provides visual modeling, team development and configuration management, development accelerators, and Web publishing and reporting capabilities
• Rational XDE Professional v2002 Release 2 - Java Platform Edition, which provides everything in Rational XDE Modeler, plus data modeling and  Java, J2EE, and JSP-based Web modeling and round-trip engineering capabilities.

Either of these packages can run as a standalone Rational XDE product, or they can be fully integrated into your IBM WebSphere Studio Application Developer (WSS AD) integrated development environment. The standalone product runs on IBM WebSphere Studio Workbench, and WSWB is installed automatically when you install this Rational XDE package.

Notes: 

• A Professional Plus package is also available, which includes both Rational XDE Professional v2002 Release 2 - Java Platform Edition (standalone and WSS AD) and Rational XDE Professional v2002 Release 2 - .NET Edition (for Microsoft Visual Studio .NET).
• 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 visual modeling features allow you to:

• 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 IDE's 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 IDE's 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 supports 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 than 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

Java, J2EE, and JSP-Based Web Modeling and Round-Trip Engineering Features

Rational XDE Professional v2002 Release 2 - Java Platform Edition provides fully integrated Java round-trip engineering capabilities in the default Rational shell. This includes code generation, reverse engineering, and automatic round-trip engineering, all of which are accessible from the shell's Project Navigator, from the Model Explorer, and from diagrams. 

As you work in the Rational XDE integrated development environment, you will find that it provides a flexible, feature-rich environment for Java and Web application development:

• Tile the Java-aware editor with your model's diagram views so you can view model and code together.
• Use automatic round-trip engineering to keep model and code synchronized.
• Use attributes or associations to represent inter-class dependencies; then toggle freely between the two representations.
• Manually or automatically apply patterns to generate bean properties, default constructors, finalizers, return bodies, and getters and setters.
• Make your model and code self-documenting with Javadoc-defined and user-defined tags and values. You can generate Javadoc comments for each class, method, or attribute; then optionally use a Javadoc tool to generate your documentation in HTML format.
• Use standard J2EE patterns to create EJB entity beans, EJB session beans, EJB Message Driven Beans, and servlets.
• Take advantage of assisted modeling to maintain consistency between implementation classes and interfaces.
• Deploy your application to IBM WebSphere, BEA Web Logic Server and the Sun J2EE Server.

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 Java Developers

When you purchase Rational XDE v2002 Release 2, you also receive RUP Configuration for Java Developers (RCJD). 

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. 

The RCJD is a role-specific process configuration of the RUP, created to provide a streamlined process for architects and developers who are building enterprise business applications. It consists of the essential developer-focused activities, artifacts, concepts, and guidelines from the base RUP requirements, analysis and design, and implementation disciplines, combined with a RUP plug-in for developing application user interfaces.

For more information on RCJD, check the Release Notes in xdeinstalldir\RationalUnifiedProcess.rcjd\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 in the form of fully integrated online Help, including context-sensitive Help.

What Help Is Available?

To access Rational XDE online Help, click Help > Contents. If the Help for an information set other than Rational XDE appears, expand the list box in the navigation area (upper left portion of the Help perspective), and select Rational XDE Help Content.

To access the complete Rational XDE information set, expand the Contents hierarchy. 

To open a Search dialog box that you can use to find any term within the Rational XDE Help information set, click the Search tab at the bottom of the navigation area. Note that the search always applies to the currently active information set. To search for Help topics or terms in any available information set, simply expand the list box in the navigation area, and click the name of the information set you want.

To access links to additional Rational XDE resources, including the Rational Developer Network, XDE Knowledge Center (which includes links to the latest version of the Release Notes), the XDE Tutorial, and other information, make sure that you are in the Modeling perspective, and click Help > Rational XDE Resources. You can also access the Rational XDE Resources topic from within the Rational XDE Help. In the Rational XDE Help Contents, expand the Modeling with Rational XDE Software Help book, and click Rational XDE Resources.

Controlling the Way that Help Is Displayed

As the user, you have significant control over how this Help appears in the Rational XDE environment. You can display Help in any of the following ways: 

• In its own Help perspective
• As an embedded Help view within any other perspective
• As an embedded thumbtack Help view within any other perspective
• As a Help view that is associated with another perspective, but that displays in an undocked, floating window

Note that because a different Help view can be associated with every perspective, you can mix and match these view types for each perspective within the same session, and have a different Help topic open in each perspective, as needed.

In addition to controlling the way Help is displayed, you can ensure that the selected topic in the Help table of contents and the actual Help topic displayed are always synchronized. To do this, click the Table icon to the right of the Help view title bar.

Displaying Help in Its Own Perspective

When you display Help in its own perspective, it completely obscures other active perspectives while it is selected. You may want to display Help this way if you are reading the Help topics to learn about some aspect of Rational XDE. However, if you want quick help on something you are working on, you may want to use one of the other methods of displaying Help.

To display Help in its own perspective, do one of the following:

• On the menu bar, click Help > Help Contents.
• Click Perspective > Open > Other... and then click Help
• Click a context topic link in an infopop when there is no embedded Help perspective available.
  Note: An infopop is a Help popup window that displays quick Help when you click F1 on a user interface item that has context-sensitive Help associated with it.

Displaying Help as an Embedded Help View

When you display Help as an embedded view in another perspective, the view is usually too small to read. However, you can resize the view, drag the view to a new location within the perspective, or quickly (and temporarily) maximize it, to make it more legible.

To display Help as an embedded Help view in another perspective:

1. On the menu bar, click Perspective > Show View > Other ...
2. In the View list, expand the Help folder, then click the Help item that appears under the folder.

• To maximize the Help view, right-click in the Help view title bar and click Maximize.
• To return the Help view to its original size, right-click in the Help view title bar and click Restore.

Displaying Help as an Embedded Thumbtack View

When you display the online Help as an embedded thumbtack view, the Help itself disappears from the screen and is replaced by a question mark icon in the left perspective toolbar. Displaying Help in this way provides fast access to embedded Help without constantly taking up your screen real estate. The fast access view cannot be moved or undocked, but it can be resized, closed, and maximized.

To display Help as an embedded thumbtack view:

1. Open the Help as an embedded view in another perspective.
2. Right-click in the Help view title bar and click Fast View. Notice that the question mark icon appears in the vertical toolbar on the left of the Workbench display.

• To restore the Help view after it becomes a thumbtack view, click the question mark icon in the left perspective tool bar.
• To minimize the Help view again, click the question mark icon in the toolbar, or click on the Minimize button in the Help view.
• To permanently remove the Help perspective, including the thumbtack view and its associated question mark icon, click the Close button in the restored Help view.

Displaying Help in a Floating Window

When you display Help in a floating window, you can move it out of the way to any location on your desktop. Note that the display options available from the context menu for the Help title bar change when you undock the window, and keep in mind that the Help view disappears when you switch to a different perspective.

To display Help in a floating window:

1. Open Help as an embedded view in another perspective.
2. Drag the view outside of the perspective and drop it anywhere on your desktop.

Back to Contents

Compatibility Issues

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. (Be careful to enter the value exactly as shown because it is case-sensitive.)

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.

Note: If you set the AppliedProfiles property and the Integrated Use Case Management shortcut menus remain unavailable, follow these steps to enable them:

1. Remove RequisitePro from the AppliedProfiles property.
2. Save and close all open models, and exit Rational XDE.
3. Restart Rational XDE, but do not open any models.
4. Click Window > Preferences.
5. On the left, expand Rational XDE and click Add-ins; on the right, click Add-in Manager.
6. In the Preferences dialog box, on the left, expand Packages and click Rational XDE; on the right, select the COMServerAddin and the RequisitePro check boxes.
7. Click Apply, click OK to close the Add-In Manager, and then click OK to close the Preferences dialog box.
8. In the Model Explorer, select the model.
9. In the Properties pane, retype RequisitePro in the AppliedProfiles property. The integration initializes and creates four required default packages in the model for use with Integrated Use Case Management, and the shortcut menus now become available.

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, consider the recommendations for setting ClearCase options, described in the following table. To access these options, click Window > Preferences; then, in the Preferences dialog box, select Rational ClearCase and click Advanced Options.

Preserving File Time Stamps During Checkin and Checkout

If you are using ClearCase 4.2 or ClearCase v.2002.05.00, or ClearCase LT v.2001A.04.00 or ClearCase LT v.2002.05.00, checking in or checking out a file that is open in an Application Developer or Workbench editor can cause a warning to appear with a message such as one of the following:

• File Changed  The file has been changed on the file system. Do you want to load the changes?
• Update Conflict  The file has been changed on the file system. Do you want to overwrite the changes?

For ClearCase v.2002.05.00 or ClearCase LT v.2002.05.00, you can resolve this issue by activating the options to preserve file timestamps when they are checked in or checked out. ClearCase 4.2 and ClearCase LT v.2001A.04.00 do not have these options, but the latest patches activate the same behavior. See Setting ClearCase Options for information on recommended ClearCase options. See Hardware and Software Requirements for supported software information.

Working with Snapshot Views

• When creating snapshot views for Rational XDE model files, be sure that the views use VOB time for timestamps and not Current time. To modify this setting, when you create the view, click the Advanced button in the Choose a Location for a Snapshot dialog box. If you do not set this option, you may be unnecessarily prompted to reload files after certain operations. One example of such an operation is a file checkout, immediately followed by an uncheckout.
• 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.

Maintaining File History

The way the IBM WebSphere Studio Workbench implements refactoring operations, such as move, rename, and delete, does not take into account the possibility of versioned namespaces (directories). This makes it more difficult to maintain an element's full history when working in an environment, such as Rational ClearCase, that does provide this functionality. In order to maintain history when using refactoring operations on Rational XDE models, and other artifacts such as Java code that are stored in Rational ClearCase, you will need to perform some operations outside the Rational XDE development environment. The steps required to perform these operations are documented in the Rational ClearCase Help, under the Tasks grouping. In this group, you will find detailed information on renaming, moving, and deleting elements. A Perl script is also provided to reduce manual steps and make these operations easier.

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 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.

• If you are installing Rational XDE as a WSS AD integration, you must install WSS AD before installing Rational XDE, and you must install Rational XDE to the same drive letter as WSS AD.

• 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. See the Supported Platforms information in the Hardware and Software Requirements for additional IBM WSS AD installation requirements.
• 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. If you are installing over IBM WSS AD, it checks that you have installed the correct version of that as well. 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 IBM WSS AD version checking: HKEY_LOCAL_MACHINE\Software\Rational Software\RSSetup\IdeCheck

Back to Contents

Installing Rational XDE

Follow these steps to install Rational XDE - Java Platform Edition:

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 as a user 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.
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. In 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.

Note: Uninstalling Rational XDE Professional v2002, Java Platform Edition for WSS AD also removes the ClearCase plug-in. When uninstalling Rational XDE for WSS AD, contact Rational Technical Support.

Back to Contents

Getting Started with Rational XDE

Starting Rational XDE

Note: If  you installed  Rational XDE to work with IBM WebSphere Studio Application Developer (WSS AD), Rational XDE is fully integrated into the WSS AD environment. Starting Rational XDE starts WSS AD, and your work can all be done within this integrated development environment (IDE).

Back to Contents

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. In the Modeling perspective, click File > New > Model.
2. Click Rational XDE in the left pane; then click Getting Started in the right pane.
3. Type the name for your model file (the default name is Getting Started1).
4. Enter or browse for the project folder in which to store the model. 
5. Click Finish to create and open the model.

Back to Contents

Creating a New Modeling Project

Once installation is complete, you can follow these steps to create a new modeling project and familiarize yourself with the many features that Rational XDE provides:

1. Click File > New > Project
2. In the left pane of the New Project wizard, click Modeling.
3. In the right pane, click the type of modeling project you want to create, and click Next.

Note: Depending on your Rational XDE package (Modeler or Professional), as well as whether you are working in a standalone (WSWB) or WSS AD environment, modeling project types can include Basic, Java, Web, Data, EJB, and Enterprise Application. The following table can help you decide which project type to choose:

Rational XDE Modeling Project	WSS AD Project	Description	Models Added to Project
Simple/Basic Modeling  Project	Simple Project	Generic project that contains files and folders.	Blank Model
Java Modeling Project	Java Project	Contain Java code; can be exported as JAR files or into a directory structure	Java Code Model
Web Modeling Project	Web Project	Contain resources for Web applications, including servlets, JSP files, Java files, static documents (for example HTML pages or images), and associated metadata. Deployed as a Web module (WAR file).	Java Code Model, Virtual Directory Model, JSP Tag Library Model
Enterprise Application Modeling Project	Enterprise Project	Contain a combination of Web modules, EJB modules, JAR files, and application client modules. Deployed as an enterprise application (EAR file).	None
EJB Modeling Project	EJB Project	Contain metadata files (such as deployment descriptor, IBM extensions, RDB mappings) for the EJB application; also contains Java source files, stubs and compiled code for enterprise beans. Deployed as an EJB module (JAR file).	Java Code Model
Application Client Modeling Project	Application Client Project	Contain resources for application client modules that run on networked client systems or for applets that run in a browser; deployed as a JAR file.	None

4. In the Project Name field, type a name for your new project.
5. If you want to use the default project root location, ensure Use default location is selected. To use another location, clear Use default location, enter another root location in Location, and click Next.
6. If you are not creating a J2EE project, click Finish; otherwise go to step 7.
7. If you are creating a J2EE project, add the J2EE SDK library to the project's Java build path. 
   Note: If you have not already downloaded and installed the J2EE SDK library from www.java.sun.com, you must do so in order to complete creation of your J2EE project.
8. In the XDE Java Project, Java Settings dialog box, click the Libraries tab.
9. Click Add External JARS.
10. Navigate to C:\j2sdkee1.3\lib\ (default location), select the file j2ee.jar, and click Finish.
11. For complete Java modeling instructions, see Modeling Java and Web Applications in Rational XDE Help.

Notes:

• To create a Basic modeling project, rather than a Java modeling project, perform steps 1 through 3. In step 4, click Basic Modeling Project, and continue to step through the wizard. 
• You do not need to complete steps 7 through 11, if you are using WSS AD and you create an EJB, a Web, or an Enterprise Application Modeling Project. You must complete steps 7 through 11, if you are using a Simple/Basic Modeling Project or a Java Modeling Project, and you want to develop J2EE 1.3 code. (Because the EJB, Web, and Enterprise Application Modeling Projects are designed for WSS AD, which only supports J2EE 1.2, they are not recommended for J2EE 1.3 development.)

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 backward 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. 

• To open a Rose model in its own new project, you can simply use File > Open to open the Rose .mdl file and save it as an .mdx file.
• To open a Rose model and associate it with an existing Rational XDE project, use the File > Import command.

In either case 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, Java models created using Rational Rose J need to go through several steps before you can use them in Rational XDE:

1. When you open and save a Rational Rose J model (.mdl format) in Rational XDE, you create a new Rational XDE Java analysis model.
2. You must then create a Java code model from the analysis model, by using the Create Java Code Model Wizard. (Access the wizard by right-clicking on the root package of the new Rational XDE analysis model, clicking More Java Actions, and then clicking Create Code Model.)
3. Finally, import any J2EE information into the Java code model by reverse engineering the deployment descriptors.

The following Rational XDE Help topics provide more information on migrating Rational Rose models to Rational XDE:

• For basic instructions, as well as details on how Rational Rose model elements map to Rational XDE model elements, see Importing Rational Rose Models.
• For instructions and details on converting Rational Rose J model elements to Rational XDE, see Migrating Rational Rose Java Models to Rational XDE.
• For instructions and details on modeling J2EE resources by reverse engineering deployment descriptors, see Importing EJB Deployment Descriptors.

Notes:

• Always back up your existing model file before beginning any conversion process into Rational XDE.
• If you are bringing a Rose J model into Rational XDE, all of the source code files that correspond to the Rose model's Java classes and interfaces must also be available. You should also keep a backup copy of the source code files because the conversion process replaces any old roseuid code markers with new XDE modelguid code markers.
• Collaboration and object 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

Restrictions and Guidelines

General

• Do not use the Perspective > Save As command to save a non-modeling perspective with the name Modeling. If you do so, you will overwrite the modeling perspective supported by Rational XDE and subsequently cause unpredictable behavior.
• The Rational XDE Modeling Perspective is designed to function on only one Workbench page at a time. If you attempt to open subsequent Modeling pages, the subsequent pages will close, and the original Modeling page will be reactivated. Attempting to access modeling features from non-modeling pages will activate the Modeling page.
• When you use File > Open XDE Model, an enclosing project is created around the file you are opening. Due to the nature of project creation, you cannot open a model located at the root of a drive, such as C:\. When you open a model file, all files and folders within the same directory are added recursively to the new project. Be aware that using File > Open XDE Model to open models in directories that contain many files and folders may involve a delay while the new project is created.
• All storage units must be located within the folder hierarchy associated with the main model file (.mdx).
• When multiple items are selected on the drawing surface or in the Model Explorer, the Property Browser will not display properties that have enumerated lists.
• You can only apply one profile to any given model. If you want multiple profiles (for example, Java and Data Modeler), you must create separate models for each profile.

Back to Contents

Moving and Renaming Model Files

When you create a model and make some of its packages into separate subunits, you must use the Model Explorer to rename or move the subunit files. If you use the Navigator or the file system to do this, the model references to the subunits will be unresolved. Note that the drawing surface will correctly show that the references cannot be resolved, but the Model Explorer will not show the icon that normally indicates unresolved references to model elements. You can confirm this problem by checking your file system for zero length storage units (a size of zero bytes) in a sub-directory under your model's root directory. These zero length files will have the same name as the original storage units.

To fix this problem if you inadvertently rename or move a file outside the Model Explorer, you must undo the move or rename operation; that is, rename the storage unit to its original name in the Navigator, or move the storage unit back to its original location using the Navigator. You must also repair the broken references caused by the update. 

If you are uncertain which elements correspond to the subunit, follow these steps to locate the subunit and repair the reference. If you know which elements and subunits should be associated, go directly to step 6.

1. On the Windows desktop, click Start > Search > For Files or Folders.
2. Enter the following search criteria:

   a. Enter *.??x as the file name for which to search.
   b. Set Look in folder to the location of your model file.
   c. Click Search Options >>; select the Size check box; set the size to at most 1 KB.
   

3. Click Search Now.
4. Note the name of any storage unit file that appears with a size of 0 bytes
5. In the Navigator window, find each file name that you noted as a 0-byte file, and delete the file.
6. Repair the subunits by associating the missing reference to each subunit

   a. Open the model and go to the Model Explorer.
   b. For each model element that should be associated to a subunit, right-click the element in the Model Explorer, click Browse for Unit.
   c. Select the appropriate subunit to complete the repair.

Important: If you want to rename and relocate subunits in the future, be sure to do so only from the Model Explorer.

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.

For information on cut/copy/paste and drag-and-drop actions specific to Java models, see Cut/Copy/Paste of Java Model Elements, later in this section.

Intra-model Considerations

• When copying and pasting Statechart and Activity Shapes:
  • If you paste a StateMachine or ActivityGraph shape to the same diagram 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 and Java Interfaces

• You can view a UML Interface on a diagram as a rectangle (that is, the shape of a class) or as a circle. You can toggle between the two representations by changing the UseClassShape property in the Property Browser.
• In Rational XDE, there is a distinction between a UML Interface and a Java Interface, the latter of which is implemented as a stereotyped class. Java code will not be generated for a UML Interface. In addition, if you create a Java Interface in a model that does not have the Java profile applied, and you later apply the Java profile to make the model a Java code model, no Java code will be generated for the Java Interface.

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/Java 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/Java 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

Partitioning Models into Subunits

When you create an XDE model and partition it into subunits, the subunits are automatically added to the project. However, if you move a model into a project, you will have to manually add the subunits to the project before you can perform configuration management operations. To do this, select all of the subunits, then right-click and select Add to Source Control....

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

Compare and Merge

Comparing and Merging Models

• Do not use the Compare and Merge command to merge two independent Java code models that do not share a common ancestor. The resulting model typically does not support round-trip engineering. Instead, for this release, use drag-and-drop or cut, copy, and, paste operations to merge such models. (See Cut/Copy/Paste of Java Model Elements for guidelines.).
  Note: You can use the Compare and Merge command to merge independent models other than Java code models and to merge Java code models that share a common ancestor.
• 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):

• Java/RTEAncestor/Ancestor
• Java/RTEAncestor/AncestorSignature
• Java/RTEAncestor/AncestorAssignmentSignature
• Java/RTEAncestor/RemovedChildren
• Java/RTEAncestor/ChildrenProperties
• FileItemsEncoding
• SaveDataID
• CodeItemsEncoding

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

Java and Web Modeling 

Application Servers

• Deployment to WebSphere 4.0 and WebLogic 6.1 does not allow spaces in the working directory path. This application server's deployment tools do not support spaces in the names of some files. Deployment fails if the working directory path includes spaces in the pathname. Workaround: Use a simple name for the working directory and do not include spaces. For example, c:\temp.
• EJB 2.0 beans are not supported on WebSphere Application Server 4.0. Enterprise Java Beans built to the EJB 2.0 standard will not deploy to WAS 4.0. The deployment tool will not show these in the selection list. 
• Rational XDE supports WebLogic 5.1,  SP 11. If you move to service pack 12 or later, you must edit the deployment script as follows:
  
  In the file, <XDEinstalldir>\Addins\J2EE\scripts\wls51_deploy_jar.bat, 
  
  change this line: set cp=%wls51%\lib\weblogic510sp11.jar;…
  
  to this: set cp=%wls51%\lib\weblogic510sp12.jar…

Code-to-Model Synchronization and Code Generation

The automatic compilation setting is enabled by default for XDE Java projects. This setting causes incremental compiles to occur as each code change is written to file, which in turn causes code-to-model synchronization and code generation to perform much slower code generation. To change this setting, click Window > Preferences > Workbench, and select or clear Perform build automatically on resource modification.

 When round-trip engineering, follow these guidelines regarding source root settings for your projects and code models:

• Define one and only one source root for the project. (Code placed under subsequent source roots will not be detected by Java RTE)
• Ensure that the project's source root setting and the code model's source root setting always match.
• Note that the source root directory corresponds to the default package for your project. Changing the location of the source root directory within your project will affect the way Java round-trip engineering determines the fully qualified package of a class and the way in which it generates package statements in code.
• In particular, once you have established a source root and have created a package hierarchy below that source root, you should avoid resetting the source root to a location within that package hierarchy. Doing so will result in loss of model classes in the code model's root package (the Java default package).

Cut/Copy/Paste of Java Model Elements

• Do not cut and paste or drag and drop such files to any other project that also contains a Java code model.  
• Do not copy and paste the file to another package in the same project. 

If you do perform these actions, the unique IDs (modelguids) present in the pasted code will be correlated to the original model element and your gesture will not be interpreted to mean "add a new class." You will then begin to see unpredictable results during subsequent round-trip engineering.

Moving nested classes in a Java code model (that is, dragging and dropping, or cutting and pasting) does not result in a corresponding relocation of the source code for those classes. It will instead result in creation of a new class with no body code at the new location, leaving the original class where it was. To complete this action, you must cut the nested class's body code from the original source file and paste it into the new source file, then delete the old nested class element from the model.

For other, general cut/copy/paste guidelines for this release of Rational XDE, see Cut/Copy/Paste Behavior, earlier in this section. 

Enterprise Java Bean Diagrams

When you create an Enterprise Java Bean (EJB) in your model, a class diagram entry is created in the Model Explorer. This diagram includes the bean component, classes, and interfaces, which you can drag and drop onto diagrams on the model's drawing surface. 

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.

Note: Do not attempt to place two XDE Java code models in the same XDE project.

When opening the model, if Rational XDE detects any unresolved cross-model references, correct  the references by using the Location Registry dialog box, which appears automatically. 

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. Eclipse

This product is accompanied by software developed by the Eclipse Project (http://www.eclipse.org).

1. XML4J 3.2.1

The Program is accompanied by software based on Xerces 1.4.2 developed by The Apache Software Foundation as part of the Apache XML project. XML4J is located in XDE\hshell\plugins\org.apache.xerces\xerces.jar. Your use of XML4J in binary code form accompanying the Program is subject to the terms and conditions of the Apache Software License 1.1 from (http://xml.apache.org/LICENSE). More specifically:

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.

Source code for XML4J is available (http://www.alphaworks.ibm.com/tech/xml4j).

2. ANT 1.3

The Program is accompanied by software developed by The Apache Software Foundation as part of the Jakarta project. The ANT code included with the Program in plugins/org.eclipse.ant.core/ant.jar includes no modifications. Your use of ANT in binary code form accompanying the Program is subject to the terms and conditions of the Apache Software License 1.1 from (http://jakarta.apache.org/ant/manual/). More specifically:

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 "ANT" 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.

3. Rhino 1.5.1

The Program is accompanied by software developed by Mozilla as part of the Rhino project. The Rhino code included with the Program in plugins/org.eclipse.scripting/js.jar includes no modifications. Your use of Rhino in binary code form accompanying the Program is subject to the terms and conditions of the Netscape Public License 1.1 from (http://www.mozilla.org/MPL/NPL-1.1.html). The Rhino binary code included in the Program includes no modifications. Source code for the Rhino binaries is available at (http://www.mozilla.org/rhino/) under terms of the Netscape Public License 1.1.

4. The Java Ssh Applet

The Program is is accompanied by software developed by Cedric Gourio. The source code is located in XDE\hshell\plugins\org.eclipse.vcm.core.cvs.ssh\vcmcvssshsrc.zip. The binary code is located in XDE\hshell\plugins\org.eclipse.vcm.core.cvs.ssh\vcmcvsssh.jar. The Java Ssh Applet is:

Copyright © 1998 Cedric Gourio
(http://www.cl.cam.ac.uk/~fapp2/software/java-ssh/)
(javassh@france-mail.com)

II. Sun J2EE Patterns Catalog

The Sun J2EE Patterns Catalog from Sun's Java Center(sm) consulting organization is included in its entirety within this product. The Sun J2EE Patterns are used with permission from the book "Core J2EE Patterns" by Deepak Alur, John Crupi, and Danny Malks, published by Sun Microsystems Press/Prentice Hall. Copyright 2001 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, CA 94303. All rights reserved. SUN PROVIDES EACH J2EE PATTERN "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.

III. ComponentOne VSFlexGrid

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

IV. Intrinsync Software J-Integra

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

V. 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 use 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.

VI. 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.

VII. 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/.)

VIII. 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.

IX. LEAD Technologies LEADTOOLS

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

X. Regex

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

XI. 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.