IBM Rational XDE Modeler
IBM Rational XDE Developer - Java Platform Edition
IBM Rational XDE Developer Plus for Java Platform

Release Notes

Version 2003.06.16, November 2006

(For new product installations)

Last Updated: 11/06/2006
GI11-4682-06


Copyright © IBM Corporation 2002, 2006. All Rights Reserved.

Any reproduction or distribution of this work is expressly prohibited without the prior written consent of IBM Corporation.

Legal Notices Information


Scope

This document contains release notes for new product installations of the Java editions of IBM® Rational® XDE™ Version 2003.06.16 (English and Japanese versions). Some information is specific to a product package, and is designated accordingly.

Go to the release notes for Rational XDE version 2003.06.16 Service Release if you are upgrading from:

The release notes document for the service release highlights added capabilities, changed software requirements, installation information, new compatibility issues, further restrictions and guidelines, and known and fixed defects since the above releases.

Note: This document was accurate at the time this product was prepared for release. The most recent version of this file is available in the IBM Publications Center at www.ibm.com/shop/publications/order. (To search for the IBM Publications Center, go to www.ibm.com and enter "IBM Publications Center" in the Search field.)

Additional updates may be available for this service release. To determine if there is an update that applies to this release, take the following steps:

  1. Browse to the Downloads and Drivers page, at http://www.ibm.com/support/us/all_download_drivers.html.
  2. Enter "XDE" in the Search field and select Updates in the Download Type field.
  3. Click Submit.
  4. Review the results list.

Choosing the Product to Install

Although packaged and purchased together, IBM Rational Rose and IBM Rational XDE are installed separately. You can use them in combination, with some limitations; however, most users will benefit from primarily using one tool or the other. In general, Rational XDE provides more advanced modeling capabilities than Rational Rose, and should be your primary choice. However, in some situations you may choose to use Rational Rose, and migrate to Rational XDE at some later time. In other situations, some team members may choose to stay on Rose indefinitely (for example, to support Microsoft Visual Studio 6) but must work with others using Rational XDE (for example, to support Visual Studio .NET).

To understand which tool to install, review the following table:

Product Your Goal... Install
All IBM Rational Rose XDE family members
  Require IBM Rational or third-party add-ins only supported by Rational Rose Rose*
  Must work tightly with a team using IBM Rational Rose Rose
  Must perform your modeling tasks on UNIX or Linux
Rose UNIX
  Require Ada language support Rose UNIX
  Are on a team or project already using Rose Rose**
  Are on a team or project already using XDE XDE**
  Have extensive SoDA reports based on Rose that have not been ported to XDE
Rose
  Have developed custom tooling which uses the Rose API Rose
  Require collaboration diagrams Rose
IBM Rational Rose XDE Modeler
  Requires business modeling stereotypes compatible with the Rational Unified Process business modeling discipline Rose†
IBM Rational Rose XDE Developer for Java
  Use Eclipse as your Integrated Development Environment (IDE) XDE
  Use IBM WebSphere Studio as your IDE
XDE
  Are using Borland Jbuilder, Visual Age, or other IDE Rose
IBM Rational Rose XDE Developer for Visual Studio
  Want to design and develop Visual Studio .NET applications
XDE
  Want to perform data modeling tasks such as schema design, database reverse
engineering, generate O/R mapping
XDE
  Want to design and develop Visual Studio 6 applications
Rose
  Want to develop ANSI C++ applications
Rose‡
IBM Rational Rose XDE Developer Plus
  IBM Rational Rose XDE Developer Plus combines Rose XDE Developer for Java and Visual Studio, and
adds support for ANSI C++ development in Eclipse, visual tracing of application execution, and IBM
Rational PurifyPlus.

* Contact your add-in provider to inquire about XDE availability.
** You may want to decompose your project to allow Rose and XDE to be used within the same project (for example, a
mixture of Visual Studio 6 and Visual Studio .NET development). Interoperability is outside of the scope of this document; please contact IBM Rational software support for further information.
† A RUP-compatible business modeling profile for XDE is available for separate download; please contact IBM Rational software support.
‡ ANSI C++ is also available to XDE users who purchase IBM Rational Rose XDE Developer Plus.

Contents

What's New in this Release
  New in All Java Platform Editions of Rational XDE
  New in Rational XDE Modeler
  New in Rational XDE Developer - Java Platform Edition
  New in Rational XDE Developer Plus for Java Platform
Hardware/Software Information
  Client Requirements
Installing and Upgrading
  Identifying the Package and Product Build ID
  Installation Issues
  Upgrading from Previous Versions of Rational XDE
  Installation Information
License Enforcement
Getting Started
  Starting Rational XDE
  Accessing Help
  IBM developerWorks Rational
Compatibility Issues
  With Rational Products
Product Documentation
  Help Behavior
  Data Modeling
  Modeling
  Web Publishing
Restrictions and Guidelines on Using this Release
  C++
  Compare and Merge
  Configuration Management
  Internationalization
  Java
  Rational XDE Extensibility (RXE)
  Web Publishing and Reporting
Defects and Changes
  Known Issues in this Release
  Defects Fixed in this Release
Contacting IBM Rational Software Support

What's New in this Release

The items listed in this section provide an overview of the most important new features in this release. Refer to the online Help for details about these features.

The capabilities available to you in Rational XDE version 2003.06.16 depend on your packaging option. To determine the package you have installed, see Identifying the Package and Product Build ID below.

For more information, see "IBM Rational Modeling Packages" in the Rational XDE Help.

New in All Java Platform Editions of Rational XDE

New in Rational XDE Modeler

New in Rational XDE Developer - Java Platform Edition

New in Rational XDE Developer Plus for Java Platform

Hardware/Software Information

Client Requirements

Hardware Requirements

The following table provides minimum and recommended system configuration requirements for Rational XDE. Rational XDE runs under the minimum configuration; however enterprise-level development is enhanced when resources conform to or exceed the recommended configuration.

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. Performance during Java code-model synchronization is significantly impaired when performed on a system with a hard disk drive formatted using the FAT32 file system. NTFS is highly recommended.

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.

For more information about hardware configuration and performance, see "Rational XDE Performance" in Rational XDE Help.

Processor Pentium III-class processor at 500MHz; Pentium III-class processor at 1 GHz or higher recommended
Available RAM

Minimum: 512 MB. Recommended: 1 GB for Rational XDE Developer versions

Available Disk Space

Minimum: 500MB for installation drive, 100 MB for workspace. Recommended: 2-5 GB for workspace

Video Minimum screen resolution: 800 x 600 pixels, 256 colors. Recommended: 1024 x 768 pixels, 16-bit color or higher
Mouse/Pointing Device Any pointing device with at least two buttons

Software Requirements

Supported Operating Systems

The following operating systems are tested and supported: 

  • Windows NT 4 SP6a
  • Windows 2000 Professional, Service Pack 2, 3, or 4 (Service Pack 4 is recommended)
  • Windows 2000 Server, Service Pack 2, 3, or 4 (Service Pack 4 is recommended)
  • Windows 2000 Advanced Server, Service Pack 2, 3, or 4 (Service Pack 4 is recommended)
  • Windows XP Professional, Service Pack 1 and Service Pack 2
Operating System Languages

Level 1 support for these languages:

  • Dutch
  • Hebrew
  • Traditional Chinese
  • Korean

Level 2 support for these languages:

  • Japanese
  • German
  • Simplified Chinese
  • French
  • Italian
  • Swedish

Notes:

  • XDE cannot be installed into a path that includes Japanese, double-byte, or extended characters.
  • The ClearCase 5.0 XDE ClearCase Type Manager installer will not function if VOB directories contain 16-bit characters. Please see Internationalization in "Known Issues."
Supported Platforms
  • Rational XDE Modeler is supported as a stand-alone version that operates in a customized Eclipse shell.
  • Rational XDE Developer and Developer Plus are supported in the following development platforms:
    • WebSphere Studio Workbench 2.0.2, 2.1.2 (which is supplied during installation), and 2.1.3
    • IBM WebSphere Studio Application Developer 5.0.x, 5.1.1, and 5.1.2
    • IBM WebSphere Studio Application Developer Integration Edition 5.0 and 5.1.1
    • IBM WebSphere Studio Enterprise Developer 5.0, 5.1.1, and 5.1.2
    • Eclipse 2.0.x, 2.1.2, and 2.1.3

Notes:

  • This release does not support IBM WebSphere Studio Site Developer or IBM WebSphere Studio Device Developer.
  • It is recommended that WebSphere Studio users download the latest WebSphere Studio product patches from IBM. In particular, users of WebSphere Studio Application Developer 5.0.1 should review defect 240508 in "Known Issues" and install the specified update.
Internet Browser
  • Internet Explorer 5.5 with Service Packs 1 or 2
  • Internet Explorer 6 without any service pack or with SP1
  • Netscape 7.0
J2EE Deployment
  • BEA WebLogic 5.1, 6.1, 7.0, and 8.1
  • IBM WebSphere 4.0 and 5.0
  • Sun J2EE Reference Implementation 1.3
Databases Supported

Rational XDE supports data modeling for the ANSI SQL 92 standard and the following database management systems (DBMS):

  • IBM DB2 UDB Windows 5.2, 6.1, 7.0, and 8.0
  • IBM DB2 UDB zSeries 5.x, 6.x, and 7.x
  • IBM DB2 UDB iSeries v5 r2
  • Oracle 7.3, 8.x, and 9i for Windows NT
  • Microsoft SQL Server 6.5, 7.0, and 2000
  • Sybase Adaptive Server 12.x
Web Publishing and Reporting Web publishing requires the Java Plug-in, version 1.3.1 or later, downloadable from the Sun Web site at http://java.sun.com/products/. Publishing a model to a folder that has double-byte characters in the name requires that you use version 1.4.1_01.
Online Documentation Display and Printing Rational XDE documentation includes a document in Adobe® Acrobat® PDF format, requiring Adobe Acrobat Reader. You can download the Acrobat Reader with Search installation kit from the Adobe Web site, at http://www.adobe.com/products/acrobat/alternate.html.
Rational Unified Process and Extended Help The Rational Unified Process, or RUP, and RUP's Extended Help, requires the Sun Java Runtime Environment (JRE) plug-in, version 1.4.1, available from http://java.sun.com/products/archive/j2se/1.4.1/index.html.
Rational RequisitePro To use the Rational RequisitePro-XDE Integration, you must have RequisitePro version 2003.06.16 installed on your system.
Configuration Management Software

Supports:

  • Rational ClearCase version 2003.06.00 or later and ClearCase LT version 2003.06.00 or later.
  • Rational ClearCase version 2002.05.00, with the latest required patch level installed.

XDE will display a warning message when the first model is opened if the ClearCase patch level on your system is less than as follows:

  • For ClearCase v.2002.05.00, patch 15

To verify the latest patch information for your version of ClearCase, go to http://www.ibm.com/software/rational/support/upgrades/patches.html

To find out which patches your ClearCase installation has installed, use the cleartool -version command in a DOS command prompt window. 

Note:

  • Users installing recent ClearCase v2002.05.00 Windows patches (for example, patch 24 or 26) should see defect 245044 below.
  • Users of IBM WebSphere Studio products who are also using ClearCase LT should see the note in the IBM WebSphere Products section of "Installation Issues," below.

Installing and Upgrading

Identifying the Package and Product Build ID

To determine the package and build ID of Rational XDE that you currently have installed, run the Rational Software Installed Product Information utility by clicking Start > Programs > Rational Software > Rational Software Installed Product Information.

Installation Issues

General

Operating Systems and Languages

IBM WebSphere Products

Preparing to Install into the Eclipse Shell

This section applies to Rational XDE Developer and Developer Plus editions only. The following instructions have been updated to describe installation into an Eclipse 2.1.x shell.

Rational ClearCase Integration

Rational PurifyPlus Integration

Rational RequisitePro Integration

Upgrading from Previous Versions of Rational XDE

Installation Information

You can find the latest version of these documents in the IBM Publications Center at www.ibm.com/shop/publications/order by searching on their titles.

Also, be sure to review the installation issues listed in this document.

License Enforcement

If you previously installed the XDE Floating License Enablement Kit, please ignore this section. License enablement of your XDE products is unaffected by this service release.

This service release enables you to manage v2003 IBM Rational XDE product's use of floating license keys.

To enable XDE license enforcement:

  1. Install the service release.
  2. Run the command <rational_directory>\common\SetXDEFloating.exe, where <rational_directory> is typically C:\Program Files\Rational. After running SetXDEFloating.exe, users will need a license key to use XDE.

After you configure XDE to use license keys:

  1. Get your license keys from AccountLink. Go to http://www.ibm.com/software/rational/support/licensing. Register with IBM Web Management and click Request and Manage License Keys. Passport Advantage customers can obtain XDE license keys by referring to the "Important Licensing and Installation Information" document in your shipment or the "Proof of Entitlement" certificate. If you are not a Passport Advantage customer, you can obtain your XDE license keys from your local IBM Rational sales representative or from Customer Service.
  2. Install the IBM Rational License Server. If you do not have the license server software, you can either install it from the IBM Rational Solutions for Windows CD-ROM or download it from https://www6.software.ibm.com/reg/rational/rational-i. Refer to the IBM Rational Software License Management Guide on the IBM Rational Solutions for Windows Online Documentation CD-ROM for instructions on installing and operating the IBM Rational License Server.
  3. Launch the IBM Rational License Key Administrator and point the client machine at your IBM Rational License Server.

When license enforcement has been activated, XDE behaves as follows:

A valid XDE license key is required throughout the duration of any XDE session, which is initiated when a model is opened and terminated when all models are closed. When the session begins, an attempt is made to check out a license key from the license server. If a license is available, XDE checks out the key for the duration of your session. If no XDE license keys are available on the server, a warning message appears informing you that you do not have a valid key. XDE will continue to operate, and you will continue to see this message while using XDE until a valid license key is acquired.

Getting Started

Starting Rational XDE

Start XDE by doing one of the following:

Additionally, XDE functionality is available once you start the shell in which it was installed.

Note: If you are using Rational XDE and a WebSphere Studio development tool with ClearCase, Rational recommends using the Rational XDE in ClearCase View command on the Start menu item instead of the WebSphere Studio Start menu command, to take advantage of the automatic pairing of ClearCase views and the Eclipse workspace provided by the XDE shortcut.

Accessing Help

For more information, see the "Help on Help" topic in Rational XDE Help.

IBM developerWorks Rational

IBM developerWorks Rational (www.ibm.com/developerworks/rational) is an online community that provides information and an exchange of ideas and best practices. Content on the site has been edited for quality and relevance, and organized by technology and process. In addition to these resources, you will find links to Web-based training. Use the site to:

Compatibility Issues

With Rational Products

Rational XDE with Rational ClearCase

Rational XDE with Rational PurifyPlus

Rational XDE with Rational RequisitePro

Product Documentation

For information about accessing the online Help provided with Rational XDE, please see Accessing Help above.

Help Behavior

HTML with Active Content

When using this product on Microsoft Windows XP Professional, Service Pack 2, you may receive warnings when using online Help. The HTML-based Help files contain active content that is on the hard-disk of the local machine. Also see defect 463810 below.

Rational Developer Network Links

Because the Rational Developer Network is now IBM developerWorks Rational, the links to the Rational Developer Network from the Rational XDE Help system may not work properly. If you are not redirected to the correct page, please go to http://www.ibm.com/developerworks/rational/ and navigate or search from there.

Data Modeling

Information About Creating Databases

The procedure for creating a database has changed. The Open Specification menu item is no longer available on the Data Modeler menu; instead, use the Preferences dialog box to set the default database target and then create the database element.

The following information is an updated version of the "Creating Databases" topic for Data Modeling in Rational XDE:

Creating Databases

Before generating a DDL or database, you must specify a database target and assign the tables in the data model to a component stereotyped as «Database». It is recommended that you create only one database component for each data model.

To create a database:

  1. Set the default database target.
    1. Cick Window > Preferences.
    2. In the Preferences dialog box, expand Rational XDE, expand Data Modeler, and then click Database Defaults.
    3. On the Database Defaults page, select a target from the Default Database Target list and click OK.
  2. Do one of the following:
    • In the Data Modeler tab of the Toolbox, click the Database tool, and then in the diagram window, click where you want to place the database. A database component is displayed in the diagram window and in the Model Explorer as an element in the data model.
    • In the Model Explorer, right-click the data model, and then click Add Data Modeler > Database. A database component is displayed in the Model Explorer as an element in the data model.
  3. In the Model Explorer, double-click the database and type a unique name for the database that corresponds to the naming conventions of the database target.

Information About Enhancements to Compare and Sync Wizard

The following information is not included in the documentation for Data Modeling in Rational XDE:

Comparing and Pairing Data

The Compare and Sync Wizard has been enhanced to include a Choose Schema dialog box a new Compare dialog box in place of the Select Synchronization Options dialog box. The Compare dialog box lets you scroll through all the database items you want to compare and synchronize, it also includes expand and collapse buttons on the toolbar to help you review your data items in outline form.

Each data item, such as tables or columns, is shaded in a color to help you differentiate the beginning and the ending of all the properties and tagged values of that item.

Differences are identified by a red font accompanied by a red triangle. The toolbar includes the import, export, delete, and ignore buttons, so you can set actions for data items with a difference.

One of the new features added to the wizard is pairing. Pairing lets you align or map data elements that are the same element in the data model and the database or DDL, but are named differently. Pairing will save the tagged values of the data element. Pairing is controlled by a Pair button on the toolbar.

To pair data elements:

  1. Click a data item.
  2. Click the Pair button.
  3. Click the matching data item.

You can also separate paired data items by clicking the Unpair button.

After you assign actions to each data item with a difference and pair the data items you want to pair, you can click Next to continue in the wizard.

Modeling

Information About Editing Event Parameters in the Diagram Window

The following information is not included in the documentation for Modeling in Rational XDE (defect 247772).

Call Event Parameters Now Appear in the Diagram Window

Parameters of an unqualified event are surrounded by a double backslash (\\), similar to messages. When you edit parameters inline using the diagram window, the parameters are created or changed for the specific event. However, on a qualified event (one with an operation), operation parameters appear. When you edit the operation parameters, the changes are ignored and are not reflected in the diagram window, regardless of whether the event has additional parameters or not.

Web Publishing

Information About Publishing Multiple Models

The following information is not included in the documentation for Web Publishing in Rational XDE (defect 141376).

Publishing Multiple Models

You can create a list of models and then publish all of the models in the list at one time.

When you publish multiple models, you must specify the full path of the root file. This is the file that you open with a browser to display the top-level view of the models. If you open any of the other generated HTML files stored in the same folder as the root file, or in any of the model subfolders, only a portion of the model is available.

Because the model publishing tool generates many files along with the root file, the Publishing Multiple Models feature organizes these files with each published model in its own folder.

To publish multiple models:

  1. Open one of the models that you want to publish.
  2. Click Tools > Publish Multiple Models.
  3. Under Add Model to the list, click Browse and specify a model.
  4. Select a level of detail for publishing the model.
  5. Click the Add button to add the chosen model to the list.
  6. Repeat steps 3 to 5 to add more models.
  7. Optionally remove a listed model by selecting it and clicking the Remove button.
  8. Under Published model root, click Browse and specify a path for publishing the models.
  9. Click Publish to publish the listed models.
  10. Click Close to close the dialog box and save the list. When the dialog box is opened again, it will show the same list of models.

After publishing, the list of models is stored at the location that you specified for published models.

Restrictions and Guidelines on Using this Release

C++

Changing the Default Text Editor for Viewing and Modifying Code

Rational XDE is installed with several text editors that have varying capabilities and interfaces. This selection of editors gives the user a great deal of choice in how to view and edit code. 

To change the default editor

  1. On the Window menu, click Preferences.
  2. Expand Workbench, and then click File Associations.
  3. Under File types, click the file type for which the editor binding is to be changed.

    Note that you can also click the Add button to add a file type that is not listed.

  4. Under Associated editors, use the Add, Remove, and Default buttons to modify the editor associated with that file type.
  5. Click OK.

Importing Rational Rose ANSI C++ Models into Rational XDE

Rational Rose ANSI C++ models can be imported to Rational XDE. Additional infomation on importing Rose models into XDE can be found in the online Help installed with XDE.

XDE and Rose Concepts

XDE works differently from Rose in a number of ways, but the most relevant are:

File Locations

XDE requires that new files be created in a directory below the project root. For instance, if you create an XDE C++ modeling project in the directory C:\myproject, new files are then created below the myproject directory.

When importing a Rose model into XDE, it is recommended that the XDE project be created in a directory that contains all the Rose source code in order to fully take advantage of the XDE product's code-browsing features. For example, if the Rose project uses source code in the directories C:\rose-project\juniper and C:\rose-project\yew, then the XDE project should be created in C:\rose-project.

Project Constraints

It is essential that XDE projects not overlap. An XDE project contains references to all file resources in the directory tree below its location (the project root). XDE does not allow multiple projects to contain references to the same resource.

You cannot have two XDE projects in the same project root. You can also not have a project in a subdirectory of another project's root directory. 

Multilanguage Projects

Rose supports projects with multiple implementation languages; that is, multiple language classes can coexist in one Rose model. If this type of model is imported to a C++ project, all the classes are converted to the C++ code model, but the Synchronize property for non-C++ classes is set to Excluded so that they do not participate in round-trip engineering.

Compare and Merge

Delivering Elements of Same Name Results in Duplicate UML Elements

After a rebase or deliver operation with identical changes made to the same UML model subunit by multiple users, duplicate UML elements occur in the resulting model if the UML elements are saved as separate subunits.

Scenario 1 - Duplicate Classifiers

When two users add a class with same name in the model (or under the same package) in their respective views, the Compare and Merge tool merges these elements automatically and the resulting model will have duplicate classes (in certain cases the diagram may also have duplicate classes). The Validate model command will then generate the following task item.

More than one Class in Model <<model_name>> has name <<class_name>>.

Resolution: Delete the duplicate class in the model.

Scenario 2 - Duplicate Components

When two users generate code or synchronize a class (which has no corresponding component in the current baseline) with same name in the model (or under the same package) in their respective views, the Compare and Merge tool merges these elements automatically and the resulting model will have duplicate components. The Validate model command will then generate the following task item.

More than one Component in Model <<model_name>> has name <<javafile_name>>.

Resolution: Delete the duplicate component in the model.

Scenario 3 - Duplicate Attributes

When two users add an attribute (with the same name to the same class) the Compare and Merge tool merges these elements automatically, and the resulting model will contain duplicate attributes. The Validate model command will then generate the following task item. 

Attribute(s) named <<attribute_name>> conflict in Class <<class_name>> 

Resolution: Delete the duplicate attribute.

Scenario 4 - Duplicate Methods

When two users add an operation (with the same name to the same class) the Compare and Merge tool merges the elements automatically, and the resulting model will contain duplicate operations. The Validate model command will then generate the following task item. 

Operation(s) "<<operation_name>>([retval]void)" in classifier <<class_name>> have conflicting signatures. 

Resolution: Delete the duplicate operation.

Scenario 5 - Duplicate Accessors

When two users add getters and setters to the same attribute of the same class, the Compare and Merge tool merges these elements automatically, and the resulting model will contain an attribute with duplicate getters and setters. The Validate model command will then generate the following task item: 

Operations "get<<attribute_name>>([retval]int)" in classifier <<class_name>> have conflicting signatures. 

Operations "set<<attribute_name>>([in]int,[retval]void)" in classifier <<class_name>> have conflicting signatures. 

Resolution: Delete the duplicate getter and setter

Scenario 6 - Duplicate Attributes and Accessors

When two users add an attribute (with the same name to the same class) and then add getters and setters to the attribute, the Compare and Merge tool merges these elements automatically, and the resulting model will contain duplicate attributes and duplicate getters and setters. The Validate model command will then generate the following task item. 

Attribute(s) named <<attribute_name>> conflict in Class <<class_name>> 

Operations "get<<attribute_name>>([retval]int)" in classifier <<class_name>> have conflicting signatures. 

Operations "set<<attribute_name>>([in]int,[retval]void)" in classifier <<class_name>> have conflicting signatures. 

Resolution: Delete the duplicate attribute. This deletes the duplicate getter and setter. If both the getters and setters get deleted, you will need to regenerate them.

Configuration Management

Pre- and Post-Installation Procedures for Migrating Your Default Workspace

If you are using an integrated Rational XDE-ClearCase configuration, please ensure that you save your team project set. After installing the release, Rational recommends that you work from workspaces collocated with their corresponding ClearCase views, which are created and managed for you when you use the Rational XDE in ClearCase view start menu item. You can use the File > Import > Team Project Set command to restore the contents of your workspace.

To save your project set

  1. Start Rational XDE.
  2. From the File menu in XDE, click Export > Team Project Set.
  3. Enter a location for the project set file. It is recommended that this location be in the view you are currently using. You need to specify a location under a project folder so the project set (.psf) file appears (after a refresh) in a project in the Navigator.
  4. Refresh the project from the Navigator. You are prompted to add the .psf file to source control.

Once the release is installed, use the following procedure to add your project set to the XDE-ClearCase view-associated workspace.

To reload your project set after installing this release

  1. Start Rational XDE using the Rational XDE in ClearCase view command on the Start menu.
  2. During startup, select the view in which you want to work.
  3. Update the view to see any project set files added on another branch or stream, using the ClearCase Update menu command.
  4. From the File menu in XDE, click Import > Team Project Set.
  5. Navigate to the location in the paired view where you stored the project set files in the workspace.
  6. Select the project set to load.
    The projects contained in the project set are added to your workspace.

Project sets are a good way to ensure that teams of developers work on the correct set of related projects. When project files are placed under source control, they can be shared among users. Any new workspace can be populated with the same set of projects by using the File > Import > Team Project Set command.

Rerunning the ClearCase XDE Type Manager Installer to Support New VOBs

For users of ClearCase version 2002.05.00, XDE performs a check upon startup to determine whether you are using ClearCase as your source control provider, and whether ClearCase has been configured to use the XDE compare/merge function as the Type Manager for XDE model files. If this configuration is needed, you are prompted to install the ClearCase XDE Type Manager.

Note: ClearCase v2003.06.00 and later includes the XDE Type Manager and these checks are not required or performed.

If ClearCase is reinstalled or a new VOB is added, then the ClearCase XDE Type Manager installer must be run again. However, before you can run the installer on the same machine again, you must first uninstall the ClearCase XDE Type Manager, and then reinstall it. As an alternative to uninstalling and reinstalling the ClearCase XDE Type Manager installer, you can choose to run the underlying script at:
<ClearCase-install-directory>\etc\utils\install_xde_eltype.bat.

Starting Rational XDE from a Shortcut

When starting Rational XDE from a shortcut, you should be aware of the following issues:

Recommendations for Working with Hijacked Files

Files are considered "hijacked" when they are in a ClearCase snapshot view and have been made editable without being checked out. In some cases, it is customary to check out the required files before disconnecting from ClearCase; however, it is not always possible to determine all the files that are required. Hijacked files are the solution to this problem. When a file is required that has not been checked out, operation systems or IDE tools can be used to make the file editable. When the ClearCase connection is re-established, these hijacked files can be converted into checked-out files.

It is recommended that you check out only the files that you need. If new files need to be modified, you will need to hijack them when disconnected. Prior to reconnecting, make sure that all your XDE models are closed and XDE is closed. You can reconnect to the ClearCase server using the appropriate method for your edition. Once you are reconnected, it is important to update your view in order to convert any hijacked files to checked out files. Then restart XDE and reopen your models.

Delivering UCM Activities

Use the following general procedure to perform a UCM delivery when using hijacked files.

  1. Prior to any UCM rebase or deliver operation, it is recommended that you close any affected XDE model. This ensures that any modifications to the files are not affected by XDE detecting the changes.
  2. Rebase either from the IDE or from other ClearCase tools, such as ClearCase Explorer. By doing a rebase operation before a delivery, you reduce the risk of problems being discovered in the integration stream.
  3. Once the rebase is done, open your model and ensure everything is still working properly. Correct any issue found during the rebase.
  4. Close the XDE models and XDE, then deliver your activities. Do not complete the delivery if you are going to verify the delivery.
  5. Restart XDE, specifying the integration view, and verify the delivery. If you find any problems in the integration stream, cancel the delivery and switch back to the development stream before correcting the issues.
  6. Once you have verified that the integration view works properly, exit from XDE.
  7. Complete the delivery.
  8. You can now restart XDE and keep on working on new activities in your development view.

Rational ClearCase and XDE Guidelines

Recommendation for Teams Using the RequisitePro-XDE Integration

Some teams that use the RequisitePro-XDE integration can improve their multiuser compatibility by establishing a PathMap for both RequisitePro projects and XDE models. If your team uses the RequisitePro-XDE integration, and if your team also meets any of the following criteria, consider following this guideline:

If your team is a candidate for establishing a PathMap for RequisitePro projects and XDE models, see the information about establishing a PathMap in the Integration Help.

Note: Rational ClearCase UCM users should be aware that, typically, you do not need to invoke the RequisitePro-XDE integration from your Integration view, only from your Development view. However, if you must invoke the integration from your Integration view, then you will need to manually update your PathMap to accurately reflect the location of the model you want to work with in your Integration view. Additionally, note that the Help is inaccurate when it states that the PathMap topic applies only to Rational Rose. In fact, PathMaps are also used for the RequisitePro-XDE integration.

Internationalization

Restrictions on Path and File Names

When installing and using Rational XDE, note the following restrictions regarding the use of Japanese, double-byte, and extended characters in path and files names:

For other related issues, please see "Internationalization" in the "Known Issues" tables below for each release (2003.06.12, 2003.06.01, and 2003.06.00 and 2003.06.10).

User-Interface Localization

In some cases, elements in the user interface may not be localized or may be incomplete. As a workaround, use F1 to read the related context-sensitive Help for that element.

Documentation

The Help for Rational XDE Extensibility (RXE) has not been localized. See the Help topic "Extending Rational XDE with Rational XDE Extensibility (RXE)."

Java

The Java/J2SE add-in does not currently support round-trip engineering of Java files that are "linked resources"—that is, .java, .class, or .jar files that are themselves defined as linked resources, resources that are outside the project itself but referenced through the linked resource path variables, or resources that are contained within a folder that is a linked resource.

Rational XDE Extensibility (RXE)

Web Publishing and Reporting

Documentation

For documentation about the Web publishing feature of Rational XDE, see the Reporting and Publishing_java.pdf Adobe Acrobat file located at <install-drive>\Program Files\Rational\XDE\Addins\webpub. This information is not included in Rational XDE online Help.

Context-sensitive help (F1 or the Help button) is not available for Web publishing dialog boxes.

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 models. If you have not already downloaded and installed the plug-in, you are prompted to do so the first time you use Web publishing 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:

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

Publishing models requires significant free disk space; use the following guidelines when publishing:

Defects and Changes

Known Issues in this Release

The following tables describe the known issues in this release, including issues found in Rational XDE Version 2003.06.16Version 2003.06.15, version 2003.06.14, version 2003.06.13, version 2003.06.12, version 2003.06.01, version 2003.06.10 (Japanese), and version 2003.06.00 (English).

In Rational XDE 2003.06.16

Category

ID

Description

General 475856 The Microsoft Windows operating system limits path names to 256 characters. This can result in an error message when you create file locations.

Workaround: Ensure that your path name includes fewer than 256 characters.

 

In Rational XDE 2003.06.15

Category

ID

Description

Documentation 141376 Update online Help to include procedures for publishing multiple models. See above, under Product Documentation, Web Publishing.
1081391/APAR
IC45594

Update online Help to include corrected procedure for creating databases. See above, under Product Documentation, Data Modeling.

Installing and Uninstalling
376974/APAR IC40695
Installing Rational XDE on a system that has unsupported shells may result in installation error messages. During the installation process, it is possible to select an unsupported shell or have it selected by default. If you continue the installation to an unsupported shell using the installation wizard, you may see installation errors or a partial installation with no errors. XDE will not function properly in this scenario. You must select a supported shell before continuing with the installation.
Web Publishing and Reporting
463810
If you are running Rational XDE with Microsoft Windows XP Professional Service Pack 2, you may see an error message when attempting to view published models. The default security restriction in Service Pack 2 prevents users from opening local Web pages with active content. Instead, the following message is displayed in the browser: “To help protect your security, Internet Explorer has restricted this file from showing active content that could access your computer."

Workaround: You have two choices for dealing with this security restriction.

To display the content while maintaining your default Internet Explorer settings for Windows XP Professional Service Pack 2:

  1. Click the message bar and click Allow Blocked Content.
  2. In the Security Warning dialog box, click Yes to display the Web page content.

To display the content by modifying the Internet Explorer settings:

  1. Start Internet Explorer.
  2. Click Tools > Internet options.
  3. Click the Advanced tab.
  4. Under Security, select the Allow active content to run in files on My Computer check box.
  5. Apply the change, restart the browser, and access the content.
General XDE
452135/APAR IC41908
The XDE Console may display an exception message when the -data option has been used with the XDE.ini "run" directive and case is being ignored in the directory parameter string. These exceptions occur when the case of the directory string specified in the -data directory parameter does not exactly match the case of the directory string on the file system.

For example, if the user creates an XDE workspace directory of C:\MyWorkspace on the file system and modifies the XDE.ini file to include the -data parameter of C:\MYWORKSPACE, Eclipse and Rational XDE will not find the workspace and will not function properly. The following exception will occur:

[ Java : nnnn-nn-nn nn:nn:nn ] Exception in JENMHC.run(): null

Workaround: To correct this, ensure that the directory specified in the -data parameter exactly matches the case of the target directory on the file system.

In Rational XDE 2003.06.14

Category

ID

Description

Data Modeler
140415
Users upgrading from Rational XDE 2003.06.12 to 2003.06.13 or later should be aware that the ODBC driver is no longer supported for connecting to a database. Instead, for most database systems, the JDBC Thin driver or ADO.NET should be used to connect. For more information, see Restrictions and Guidelines on Using this Release, Data Modeling.
140416, 140865

As of Rational XDE 2003.06.13, the details for connecting to IBM DB2 and Oracle databases have changed. In addition, the list of supported drivers has changed. In some cases, the following error message is displayed during a test connection: "Unable to connect to the database with the specified information. Please verify the connection information."

Workaround: For more information, see Restrictions and Guidelines on Using this Release, Data Modeling.

728904

Certain versions of the client connection tools (DB2 UDB Personal Edition or DB2 Connect Personal Edition 8.1) may stop working with the DB2 UDB database system. This may cause the reverse-engineering process to freeze when going from the database to the data model in XDE.

Workaround: First, generate the DDL script from the database, and then reverse engineer from the DDL script to the data model.

Installing and Uninstalling
140764

This is an issue when installing the Rational XDE 2003.06.14 service release for the following products: Rational XDE Developer - Java Platform Edition and Rational XDE Developer Plus for Java Platform Edition.

During installation of the service release, the user will be prompted to insert the Disk 1 from Rational XDE 2003.06.13.

Workaround: Do the following:

  1. When you see this message window, insert Disk 1 of the same Rational XDE 2003.06.13 product being updated.
  2. Wait for the Rational XDE 2003.06.13 installation wizard to appear, then cancel the XDE 2003.06.13 installation wizard.
  3. Click the OK button on the XDE 2003.06.14 installation wizard to complete the XDE 2003.06.14 upgrade process. The upgrade installation should complete without error.

In Rational XDE 2003.06.13

Category

ID

Description

Documentation
247772
Update online Help to address editing of event parameters in diagram window. See above, under Product Documentation, Modeling.
459662

The online Help for freezing a model incorrectly states an expected setting. In steps 3 and 4 of the "Freezing Include Models" topic, you are told to look for the text unitPolicy ="1". Instead, you will normally see unitPolicy="0" when opening a .mdx file.

General XDE
247316

When using Rational XDE version 2003.06.13 with WebSphere Studio Application Developer 5.0.x, an error message may be displayed upon exiting XDE.

Workaround: Although the workspace is not affected, you can prevent the errors by upgrading to Application Developer 5.1 or above.

247693/APAR IC40927
Hotspots created for elements contained in swimlanes (whether merged or not) may not be placed in the expected location.

In Rational XDE 2003.06.12

Category

ID

Description

C++
245816
You may be unable to close the C++: Add Source files dialog box because of a reappearing error message dialog box. This happens if you click the Add Files button and enter a nonexistent directory name, and then click the Add Recursive button.

Workaround: The C++ Add Source files dialog box can always be closed by pressing the ESC key.

Configuration Management
245044

Rational XDE customers who have installed recent ClearCase v2002.05.00 Windows patches (for example, patch 24 and 26) will start receiving prompts to reinstall the XDE/ClearCase Type Manager Installer. This is due to the ClearCase patch overwriting the XDE bindings in ClearCase control files that steer compare and merge operations to the XDE compare/merge facility.

Workaround: Uninstall and then perform a reinstall of the XDE/ClearCase Type Manager Installer on the server and on the client. This will have to be repeated after every ClearCase patch install. Monitor future ClearCase patches for fixes for this issue. XDE customers who also use the WebSphere Studio Application Developer 5.1.x UML Diagramming feature should contact IBM Rational Software Support for assistance.

Data Modeler
244321

After you use Petal Import to open an existing Rose model in Rational XDE, you must do the following:

  1. Reset the data model default database target.
  2. Reset the domain database target.
  3. Assign the domain package to the data model using a dependency relationship.
244285

The many-to-many relationship tool does not correctly resolve table names that contain apostrophes ( ' ).

Workaround: Remove the apostrophes or create the relationship manually.

To create a many-to-many relationship manually:

  1. In a diagram, add the tables that participate in the many-to-many relationship.
  2. On the Data Modeler tab of the Toolbox, click the Table tool, and then click the diagram that contains your many-to-many relationship tables. The new table created is your intersection table.
  3. Add an identifying relationship between each of your many-to-many relationship tables and the intersection table. The intersection table must be the child table of each identifying relationship.
  4. Set the multiplicity of each identifying relationship to 1..*
244364

Additional DB2 templates are visible when creating a DB2 UDB zSeries data model.

Workaround: Select only the templates titled "DB2 zSeries." The other templates (MVS) are for those with data models from previous versions of Rational XDE.

244570

DB2 UDB zSeries large tablespaces cannot be reverse-engineered or generated to a database or DDL file.

244568

Rational XDE data modeling offers limited support of DB2 UDB zSeries version 8; i.e. only version 7 elements and statements are supported.

To use DB2 UDB zSeries version 8 in a data model, you must use the DB2 UDB zSeries v6 & v7 database target in the engineering wizards and the database default.

This support is based on pre-GA DB2 UDB zSeries version 8.

244557

When you reverse engineer DB2 UDB zSeries functions, the return type defaults to smallint.

Workaround: Reset your return type after the reverse engineering process is complete.

244453

When reverse engineering DB2 UDB zSeries from the database, the tablespace erase rule does not reverse engineer.

Workaround: Set the tablespace erase rule using the IsErase property. Set this property to True for ERASE YES, or set it to False for ERASE NO.

244569

Columns that use computed columns as a default value receive an unresolved identifier error when validating a data model. This is not a valid error.

Workaround: Ignore the error.

244555

A view dependent on another view is reverse engineered from the database as a user-defined view, so a dependency relationship between the views is not created.

244571

When you reverse engineer DB2 UDB zSeries nullable columns from the database, Rational XDE assigns a Null default value to the column.

Workaround: To preserve your column syntax when you generate to a DDL file or database, remove the Null default value from the column.

245539

If you remove a pk/fk from a table, and attempt to export the entire table to a DDL file using Compare and Sync without validating the model, then you will recieve an ArrayOutofBoundsException error. If you encounter this error you must restart XDE.

Workaround: Validate the model (as recommended in the best practices) and fix the invalid relationship before proceeding with Compare and Sync.

245839

WSSAD 5.0.1. If you created a DB2 UDB data model in Rational XDE 2003.06.01 Service Release, and then upgraded to the XDE 2003.06.12 Service Release, XDE may not respond when you attempt to open a Specification dialog box for DB2 UDB database elements created prior to the upgrade. This is due to incorrect identifier lengths or an incorrect maximum identifier length default. If XDE stops responding you must restart XDE.

Workaround: In XDE 2003.06.12 Service Release, reset the Data Modeler Database Defaults preference to increase the maximum identifier length, or shorten the length of the existing identifiers within the model.

245889/APAR IC39101

The Rational XDE Help for Data Modeler should include the following information: When performing multiple transformations of the logical data model to a data model you can re-transform your logical data model to different data model packages for each transformation. If you want to re-transform your logical data model to the same data model package for every transformation, you must be aware that XDE does not:

  • Synchronize between the logical data model and the data model. If you deleted elements in the logical data model, those elements are not deleted in the data model.
  • Generate indexes for foreign keys, even if you specify that in the class to table transformation dialog box.
  • Generate some constraint names correctly.
Documentation
243667
The Javadoc version of the RXE API documentation does not reflect the inheritance model used in the Patterns and Code Templates portion of the API. The actual inheritance used is as follows (indentation indicates inheritance.)
  • IRXEPatCTCalloutData
    • IRXECodeTemplatesExpansionData
    • IRXEPatCalloutData
      • IRXEPatVetoableCalloutData
        • IRXEPatternsOnArgumentValueCalloutData
        • IRXEPatternsOnBindCalloutData
        • IRXEPatternsOptionalElementCalloutData
        • IRXEPatternsWizardCleanUpCalloutData
        • IRXEPatternsWizardStartUpCalloutData
        • IRXEPatternsExpansionLocationCalloutData
      • IRXEPatAbortableCalloutData
        • IRXEPatExpansionCalloutData
          • IRXEPatternsPreExpandCalloutData
          • IRXEPatternsPostExpandCalloutData
        • IRXEPatternsPreApplyCalloutData
        • IRXEPatternsPostApplyCalloutData
        • IRXEPatternsErrorCalloutData
        • IRXEPatternsPostMappingCalloutData
        • IRXEPatternsCollectionCalloutData
      • IRXEPatElementCalloutData
        • IRXEPatternsMergeCalloutData
        • IRXEPatternsMatchCalloutData
        • IRXEPatternsScriptletCalloutData
  • IRXEPatApplicationMap
  • IRXEPatExpansionMap
  • IRXEPatCTCalloutUser
    • IRXECodeTemplatesExpansion
    • IRXEPatternsCallout
  • RXEPatCTArgumentTypes
  • RXEPatApplicationEvents
  • RXEPatNextOptions
  • RXEPatElementMergeBehaviors
245889/APAR IC39101
See the description for defect 245889 above, in the "Data Modeler" section of this table.
453915

In Rational XDE Help, an incorrect description is included in the topic “Defining Code Template Bodies.”

Workaround: In this topic, within the "For a Body Kind of Java" section, the interface name IRXECTCallOutUser should be replaced with IRXECodeTemplatesExpansion.

Installing and Uninstalling
137437

When installing into IBM WebSphere Studio Application Developer version 5.1.1, it may be necessary to upgrade the underlying Java Runtime Environment (JRE).

To determine whether an upgrade is necessary after installing this service release, you must check the two build identification numbers associated with the JRE within WebSphere Studio Application Developer.

  • Find the first number by running the following command, where <WS_JRE_Path> is the path to the JRE directory within Application Developer: <WS_JRE_Path>\bin\java.exe -version
    The JRE version information is returned, and the build identification number is included.
  • Find the second number by running the following command:
    < WS_JRE_Path>\bin\java.exe -Xj9 -version
    The J9 version informaiton is returned, and the build identification number is included.

You do not need to upgrade the JRE if the following versions are returned:

  • JRE build identification number: 20031021
  • J9 component build identification number: 20031201

If you see any other numbers, then the JRE was not upgraded and you must do the upgrade manually.

Note: The WebSphere JRE will be upgraded during installation of this service release if the JRE build number is 20031021 and the J9 component build number is 20031021 or 20031103. The JRE build number does not change when upgraded.

Workaround: Manually upgrade the JRE by manually copying the following directory to the jre directory within WebSphere Studio Application Developer 5.1.1:
<XDE-install-location>\Rational\Common\XDE_WSAD_JRE_UPDATE\jre

This directory includes all the files required to upgrade the JRE.

242345

Under Windows NT, XDE may fail to install into WebSphere Studio Application Developer 5.0.1 if the value for the NT 4 registry size is less than 40.

Workaround: Set the NT 4 registry size to 41 or more: Right-click My Computer, click Properties, click the Performance tab, click Change under Virtual Memory, and set Maximum Registry Size to 41 or greater.

Internationalization
237570

The default font used on the drawing surface is not suitable for all languages (especially Asian languages).

Workaround: Users should change the default font face in the Preferences dialog box (on the Windows menu) by expanding Rational XDE and Appearance, and then clicking General. Choose a font that supports your character set. Also, select Default for new models in the Settings for list to ensure that the change applies to all new models.

245756

An English-language error message appears when starting the Rational Unified Process, or RUP, and RUP's Extended Help, if you have not installed the Sun Java Runtime Environment (JRE) plug-in, version 1.4.1, for your Web browser. For a workaround, see defect 245756 under "General XDE."

J2EE
243880
When the web.xml file declares more than one filter URL pattern and the file is externally modified to delete a URL filter pattern, the tag editor does not update the file correctly. The web.xml file is invalid because an empty tag exists representing the deleted filter URL pattern. The errors occurs on reimporting the modified web.xml file.

Workaround: In the Web deployment model, select the servlet filter with the externally removed Web filter URL pattern. Then, in the Properties window, open the tag editor for the WebFilterURLPattern property, click OK, and close the tag editor. This triggers the system to clean up the blank Web filter URL pattern.

243962

The deployment descriptor editor for IBM WebSphere Studio Application Developer does not always refresh immediately after a Rational XDE-Application Developer synchronization. As a result, changes made from XDE may not be visible in Application Developer until the user closes and reopens the editor. For example, when a CMP field is added to an Entity Bean in XDE, the new CMP field is shown in the J2EE hierarchy, but not the CMP field section of the Bean tab.

Workaround: Close and reopen the editor.

RXE
243418
The RXEMenuExtender target tag <AppendSelection> currently appends only the specific elements selected. It will not append a grouped set of elements.
244437
If a model is opened in RXE via a program called by the Menu Extender before the Model Explorer has initialized, the model will appear in the Model Explorer only if a write action has been opened prior to opening the model. If either a read action or no action is open, the model will not appear in the Model Explorer.
244495
If a model is closed by a program called by the Menu Extender, it will still appear within the Model Explorer.
244507
The Menu Extender samples referenced in the documentation, including the appropriate target programs, are stored in C:\Program Files\Rational\XDE\Addins\RXEMenuExtender\examples. This path is subject to change depending on your installation location.
244508
IRXEDiagram.renderImage( ) does not support the .GIF format in this release.
244560
RXE scripts run from a menu that create and save models to a configuration-management-controlled directory will not be added to the configuration management system under the .NET shell. These models will only be added to the configuration management system under the Eclipse shell.
Visual Trace
135408

The IBM Java Runtime Environment (JRE) that ships with the IBM WebSphere Studio Application Developer platforms prior to version 5.1 does not provide the ability to use Visual Trace when running in debug mode. As a result, users of the Rational XDE Developer Plus for Java Platform Edition who engage Visual Trace will not produce a trace sequence diagram when J2SE applications are run in debug mode.

Workaround: An updated version of the JRE is included with the XDE product media. For installation instructions, see the related "Installation Issues" note under IBM WebSphere Products. Alternatively, you can upgrade to Eclipse version 2.1 or WebSphere Studio Application Developer version 5.1.

Web Publishing and Reporting
243697

If you filter out a particular element type (such as Text), hot spots that have no associated links may be created in the published model.

Workaround: Remove all filters before publishing a model.

245328
If you try to publish a model without having the Java Runtime Environment (JRE) installed, XDE displays a message that prompts you to install the 1.3.1 release of Java Plug-in Software. After installing Java Plug-in 1.3.1, when you try to publish a model, XDE displays the following error message:

Java(TM) Plug-in 1.4 Fatal Error
Java Plug-in 1.3.1 cannot be located because values in the registry key
HKEY_LOCAL_MACHINE\SOFTWARE\IBM\Java Plug-in\1.3.1 is not found or is no longer valid.

Workaround: Install the 1.4 release of Java Plug-in Software before or after installing XDE.

375379
If you are linking an external file to a model element, you can specify the file reference for the link with either an absolute path or a relative path. File references that are specified with relative paths do not publish to the Web correctly.

Workaround: If you want to publish a model to the Web, specify only absolute paths for all linked files.

To specify an absolute path for a linked external file, do the following:

  1. In the Model Explorer, right-click the model element to which you want to link an external file, and then click Add UML > URL.
  2. In the URL Input Dialog dialog box, clear the Use relative path representation for all file references check box.
  3. Click Browse, browse to and select the file that you want to link to the model element, and then click Open.
  4. Click OK in the URL Input Dialog dialog box.
General XDE
44806

When you open a dialog box to browse to a folder in IBM WebSphere Studio Workbench on Windows NT 4, the dialog box may lose focus and be obscured by other dialog boxes.

Workaround: Use Alt + Tab change focus or click the desired dialog box. This a known issue for Eclipse running on Windows NT.

243239

When you export a Rational XDE model using the XML Metadata Interchange (XMI) file format, the following harmless error messages may appear if the ClassicRose profile is applied to the model you are trying to export and the model contains XDE-created realization and abstraction relationships:

  • Tagged value "ClassicRose::Visibility" not found for element "xx_Abstraction"
  • Tagged value "ClassicRose::Friend" not found for element "xx_Abstraction"
  • Tagged value "ClassicRose::MultiplicityTo" not found for element "xx_Abstraction"
  • Tagged value "ClassicRose::MultiplicityFrom" not found for element "xx_Abstraction"

The error messages appear because there is no UML:Realization metaclass in UML/XMI. On XMI export, Rational XDE realizations and abstractions stereotyped as "Realize" are exported as UML:Abstraction stereotyped as "Realize". On XMI import back into Rational XDE, all abstractions with “Realize” stereotypes become realization relationships in XDE.

244103
If you click a class shape in the diagram window, then click the diagram surface and click a class shape again, the check marks displayed in the Show/Hide Compartment list on the Appearance toolbar do not update to show which compartments are currently visible on the last class shape selection.

Workaround: Change the selection directly from one class shape to another class shape to display the correct settings or select another class shape and then reselect the desired shape to update the list.

244643, 244687

When you export a Rational XDE model to the Unisys 1.3.5 file format, multiple state and final state actions (such as do, exit, and entry) are not exported. When you import the Unisys 1.3.5 file back into XDE, only one action (a do action) is imported. All actions (UninterpretedActions) should export and import correctly.

Workaround: Remove multiple actions that reside within an activity model element before exporting a model in the Unisys 1.3.5 format.

244776
You can add multiple events such as signals, calls, and time events to a transition in Rational XDE. However, when you export an XDE model that contains transitions with multiple events to the Unisys 1.3.5 XMI file format, you cannot import the same model back into XDE.

Workaround: Add one event per transition when you want to associate multiple events with a transition.

245150
If you export a Change Event model element with the Change property assigned to a specific string, the export representation generated in the XMI file is incorrect. The attribute "body" is generated twice, which causes the exported result to be incorrect syntatically.

Workaround: Change the duplicate attribute "body=" to "language=" in the exported XMI file.

245197

If you are running Windows 2000 and have installed the Japanese version of this service release into the IBM WebSphere Studio Application Developer version 5.1.1 shell, the Help window may become corrupted or hang if you switch between the Help window and other windows.

Workaround: Close the Help window and restart the shell. The next time you use Help, it will work normally.

245408

Associating one constraint with multiple model elements causes XDE to hang during an XMI import.

Workaround: Only associate one constraint with one model element.

245427
Activity graphs with a SubactivityState reference export to an XMI file format correctly; however, when you import the XMI file back into XDE, the reference is not interpreted correctly. The imported model will not have an ActivityGraph reference for a SubactivityState. There is no workaround for this defect.
245430
Object Flow States with a Classifier reference export to an XMI file format correctly; however, when you import the XMI file back into XDE, the reference is not interpreted correctly. The imported model will not have a Classifier reference for an Object Flow State. There is no workaround for this defect.
245432
Call Events with an operation reference export to an XMI file format correctly; however, when you import the XMI file back into XDE, the reference is not interpreted correctly. The imported model will not have a operation reference for a call event. There is no workaround for this defect.
245756

The Rational Unified Process, or RUP, and RUP's Extended Help, will not work if you have not installed the Sun Java Runtime Environment (JRE) plug-in, version 1.4.1, for your Web browser. In addition, the related error message appears in English and is not localized.

Workaround: Install Sun JRE 1.4.1.

To install the JRE plug-in, do one of the following:

  • If you have installed RUP from a CD, you can execute the JRE plug-in installer from the Rational common directory:
    [INSTALLDIR]\common\rwp\JRE_plugins\j2re-1_4_1-windows-i586-i.exe
    where [INSTALLDIR] is the installed Rational products directory. For example,
    C:\Program Files\Rational.
  • Download and install the JRE from the Sun Java Web site, using this link:
    http://java.sun.com/products/archive/j2se/1.4.1/index.html

For other options, please contact your organization's technical support staff.

When finished installing, restart RUP or Extended Help.

In Rational XDE 2003.06.01

Category

ID

Description

Internationalization
595383, (82143)
This defect now applies to all Java platform editions. When downloading the Java plug-in required for Web publishing, if you are running a Japanese operating system, you must choose the International version of JRE from the Sun Web site (for Netscape) or select the appropriate Locale (for Internet Explorer).
General XDE
242670

The product version number displayed in the About Rational XDE Features dialog box shows "2003.06.00" instead of the Service Release 1 version number, "2003.06.01." You see this by clicking Help > About Rational XDE, clicking the Feature Details button, and then clicking the Rational XDE feature row.

Please reference the version information provided by the Rational Software Installed Product Information utility.

In Rational XDE 2003.06.00 and 2003.06.10

Category

ID

Description

Compare/Merge
239157

Occasionally, you may see that the number of conflicts reported during an XDE Compare/Merge session appears to be inconsistent with the state of the conflict navigation buttons and menu items. For example, the status bar indicator may show that there are two unresolved differences remaining to be resolved when the Navigate to Next Unresolved Difference button and menu item are unavailable. This may happen when conflict resolution propagation automatically resolves other conflicts in response to a conflict you have resolved, as when you resolve a conflict involving the deletion and renaming of a class by deleting the class. In that case, the conflict resolution is automatically propagated to remove views of the deleted class from diagrams, thereby resolving dependent conflicts. However, the conflicts that are resolved automatically may not correctly be reflected by the conflict count.

If you encounter a situation where the status bar count indicates that there are differences remaining to be resolved, yet navigation to the next and previous unresolved differences is not available (dimmed), then the conflict count is incorrect; you have, in fact, resolved all conflicts. In this case, you can ignore any warnings about unresolved conflicts when you save and end your merge session or commit the merge session to ClearCase.

239437

If you initiate a ClearCase operation that leads to an XDE merge session, you may not realize that ClearCase is waiting for the XDE merge session to complete if XDE is minimized or if the ClearCase dialog boxes obscure an XDE dialog box. It may appear that ClearCase is hung.

Workaround: Simply bring XDE to the foreground, if it was minimized, or click the XDE window to bring any of its dialog boxes to the foreground.

511988, 513261
When fusing three or more models, you may encounter cases where conflicting differences do not generate conflicts when there should be conflicts.

Workaround: Perform several sequential merge sessions in which you fuse two models at time in each session, until you have fused all of the models.

513914

When Rational ClearCase initiates an XDE merge session involving a diagram that is a separate unit, occasionally the diagram cannot be opened from the Model Explorer. This occurs when certain information necessary to open the diagram resides in a parent unit of the diagram unit and is, therefore, not present during the merge session.

Workaround: Once the merge session completes, you should be able to open the model and then open the diagram without difficulty.

Configuration Management
51338

If you drag and drop a Java class from a Rational ClearCase source-controlled file that has already participated in round-trip engineering operations from one package to another in the Model Explorer and answer "no" when prompted to check out the model, the Java file related to the class will not be placed back into ClearCase version control.

Workaround: You must refresh the package that the file was moved from in the Navigator. You will then be prompted to add the Java file to ClearCase source control. It is possible that you may not be prompted based on ClearCase preference settings. By default, XDE prompts you to add all new files to ClearCase.

239662

When upgrading older models, the profile upgrade process will not complete successfully if there are any missing model subunit files.

Workaround: A utility that fixes models in this state is available on the Rational Developer Network. If you cannot locate the utility, the Rational XDE v2003 Model Repair Tool, contact Rational Software Support for assistance.

240329

When opening a model from an older version of XDE, the user is prompted to upgrade the model. If the model is version controlled, and it also references another model that is not currently in the shell workspace, an upgrade failure may occur and the model cannot be opened. A Model Upgrade Failed window opens and displays the following message:

Models were not upgraded successfully because some of the files needing change could not be edited.

Workaround: Before upgrading, add the referenced model's project to the shell workspace. If the referencing model is now opened, the upgrade will succeed.

513422

The menu items related to source control may not appear on the shortcut menu for a model in the Model Explorer.

Steps to reproduce the problem:

  1. Create a simple project under source control.
  2. Add the project to a blank model.
  3. When prompted, check in the project.
  4. Right-click the model node in the Model Explorer.

To reactivate the menu items, change the focus from model to the main diagram node in the Model Explorer, and then back to the model. This forces the menu items to appear.

Data Modeling

239118

 

The transformation feature that creates EJBs from database tables incorrectly creates Container Managed Relationships (CMRs) between CMP 2.0 remote entity beans, which are not permitted.

Workaround: Delete the CMRs and manually create the appropriate source code to invoke the remote beans.

239345
When you transform a database view to an Entity EJB, add a primary key to the bean, then transform from the EJB back to the view, you get a new table instead of a database view. The expected behavior is that the new primary key will be transformed to a regular view column.
240103

When you use JDBC for DB2 connections, you must verify that the XDE JDBCdriverpath points to the DB2 client. To do this, follow these steps:

  1. Before running XDE, click Start > Run, and type regedit.exe.
  2. Go to the HKEY_LOCAL_MACHINE\SOFTWARE\Rational Software\XDE\AddIns\Data Modeler registry key, click the JdbcDriverPath value, and then verify that this path is valid and points to your db2java.zip file.
595696

The WebSphere 5.0 deployment descriptors contain the types and names of the columns mapped to CMP fields. There are many different database-specific versions of the deployment descriptors. During deployment from XDE, those types are generated by running an external WebSphere deployment tool and not from the "Data Transform" mapping between EJB and Data Models. Therefore, the values will not reflect your data transformation mappings.

Workaround: If you use WebSphere Studio Application Developer, the best workaround is to use its mapping editor and deployment feature; otherwise, you will have to settle for the default mapping as a first choice. If you must make mapping changes, you have to resort to hand editing the XMI descriptor, which is difficult. However, once you have the correct mapping and schema files generated, XDE can use these files by overriding the normal process that generates new ones. In the deployment model, use the EJBNonModelElements tag on the EJB-Jar Archive to prevent it from being regenerated during deployment.

Installing and Uninstalling
58682
The administrator who installs Rational RequisitePro as part of the RequisitePro-XDE Integration should launch RequisitePro before a user without administrator permissions attempts to use RequisitePro from Rational XDE. Failing to do this may cause XDE to freeze.
223368 (65785)
Due to the installation image's large 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.
236721

The following error occurs when an excessively long install pathname is specified:

Error 1320. The specified path is too long <pathname>

If the installation is then cancelled by clicking Cancel, the installer will exit, but the folder %INSTALLDIR%\RCSI\ and its contents will remain on the system. The RCSI folder and its contents should be deleted manually.

236727
The installer does not check to see if the destination install directory is a valid Windows directory. If a bad directory name is entered—for example, one with bad characters—the install may complete, but the installed product will probably not work correctly.
237629

If you have installed the Visual Studio .NET edition of XDE, followed by an install of XDE for Java, on the same system, the file associations for the .mdx and other modeling files are now associated with the XDE for Java product. If you uninstall the XDE for Java product, the icons associated with the file associations are uninstalled. This leaves the VS .NET edition of XDE functional, but some file icons are missing and are displayed with Windows generic icons.

Workaround: To restore the icons, reinstall the XDE for VS.NET product.

239439

If you install Rational XDE into WebSphere Studio Application Developer version 5.0, install PurifyPlus (or a Rational Suite product containing PurifyPlus), and you choose to integrate PurifyPlus into Application Developer 5.0, and then uninstall PurifyPlus, you will get a number of harmless error messages the next time you start Application Developer. These errors include, "Error Restoring Editor," "Modeler Error: Failed to load modeler."

Workaround: Exit Application Developer, remove the .metadata directory in your workspace, and restart Application Developer. Application Developer will rebuild a clean metadata directory and the errors will not occur.

240630
If you reach the Ready to Install page in the installation and want to return to an earlier page by using the Back button, you should cancel the current installation and restart the installer from the beginning. Using Back from the Ready to Install page may not properly initialize the shell selection page and may cause a failed installation.
241162
Use of the Microsoft Windows XP "Run As" feature is not supported by the Rational Installer for Rational XDE version 2003. Please log in to an account with local admininstrative priviledges and run setup directly from this account.
447036
XDE will not work properly if it is installed into a folder on a network share. Use a local drive instead.
512648
If you plan to install XDE into IBM WebSphere Studio Application Developer, Application Developer Integration Edition, or Enterprise Developer, be sure to reboot your system after installing the IDE, if you have not already done so, and before installing XDE.
514497
If Rational PurifyPlus is installed into the same shell as Rational XDE Modeler or any XDE Developer for Java Platform product, and then PurifyPlus is uninstalled, XDE displays the following error message upon startup: "Modeler Error: Failed to load Modeler." You can ignore the message. XDE continues to operate normally.
593408, (78359),
594321, (80161)
If you install both the Java and .NET editions of XDE on the same system, round-trip engineering tools for both editions appear in both editions' toolboxes. For example, C# tools and Java tools appear in both environments. However, the tools only work in the environment for which they are supplied.
596111, (83538)
When installing XDE, do not use the # character in your install path.
596504

When both the Java Platform and .NET versions of XDE Developer have been installed, model files (.mdx) are associated with whichever version was installed last. If that latter version is then uninstalled, the association is not removed because there is still an XDE Developer version installed. As a result, if an .mdx file is then opened, the wrong association will be used.

Workaround: Manually change the association to the remaining XDE Developer installation shell.

597536, (86372),
597595, (86501)
Installing previous versions of XDE over newer versions of XDE is not supported.
Internationalization
44550
Eclipse has problems with Japanese characters in some cases. Exporting a file with Japanese characters in its name to a Zip file results in the filename being altered. Exporting the same files to a file system works without a problem. In addition, using Eclipse to create a new Java class that is in Japanese characters causes the file to be created successfully, but the class name is not added to the file.
595383, (82143)
When downloading the Java plug-in required for Web publishing, if you are running a Japanese operating system, you must choose the International version of JRE from the Sun Web site (for Netscape) or select the appropriate Locale (for Internet Explorer).

135347

 

Java files must contain native characters only, in order to be processed correctly by Java RTE in XDE. For example, when running on a Japanese platform, Java files should contain only characters found in code page 932. This is a limitation of the underlying JRE implementation of FileOutputStream, which is used by XDE for file I/O.
234644
In some cases, XDE uses the generic Eclipse text editor to display text. On non-English systems, if the text characters are displayed incorrectly, then the default text encoding is probably incorrect. In the Preferences dialog box, expand Workbench, click Editors, and set Text file encoding to the appropriate value for your language. (Note that this is an Eclipse defect.)
236978
Installation of XDE will succeed only if the pathnames for Enterprise or Silent Install locations do not contain Japanese or multibyte characters. Similarly, if you copy the CD image to a share and attempt installation from such a path, the share name must not contain Japanese or double-byte characters. If you share the CD drive of a machine so that others can map to it to perform an install, the share name must not contain Japanese or double-byte characters.
240139

When using XDE integrated with ClearCase, Register New Location fails if the XDE project name contains Japanese or double-byte characters and is under source control.

Workaround: Avoid using Japanese or double-byte characters in project names.

240590
XDE cannot be installed into a path that includes extended characters.
243009

If you are using IBM WebSphere Studio Application Developer 5.0.1 on the Japanese version of Microsoft Windows XP, the online Help does not work properly. The table of contents for Help appears empty. Also, the Advanced Search dialog box does not show all of its buttons or contents.

Workaround: To see Help for Rational XDE, click Help > Rational XDE Resources instead of Help Contents. If the table of contents is not visible after you click the Table of Contents icon in Help, click Help > Rational XDE Resources. To use the Advanced Search dialog box, enter your search text and press Enter. Your search will be performed across all installed Help components. Note that context-sensitive Help is also available, using F1.

449850

A Rational XDE diagram that contains Japanese or double-byte characters may not display correctly if you copy the diagram and paste it into Microsoft Word. (This is an issue for Japanese and English versions of Word.)

Workaround: Select all shapes, change the font for the selected shapes to an appropriate font, such as MS UI Gothic, and then copy and paste the shapes into Word (or another application).

450403

Users may be unable to find Rational XDE Help topics when using Japanese keywords in the Advanced Search dialog box for Help in the Japanese edition of IBM WebSphere Studio Application Developer. This problem occurs when Application Developer is started from the Start menu. (Also see defect 243009.)

Workaround: Before performing your search, start Application Developer using the Rational XDE command on the Start menu, as follows:

  • Click Start > Program Files > Rational Software > Rational XDE Developer for Java.
592549 (76416),
594534 (80571)

If the operating system language is different from the language of the character set you are using to enter text, when project files and storage units are created using extended characters, the extended characters are displayed correctly in diagrams, but not in the Model Explorer. Other display character problems may also occur.

Workaround: Ensure that the operating system language and the text-entry language are the same.

595126
Rational XDE does not support Japanese line breaks; therefore, when using reverse engineering in data modeling with version 2003.06.12 (Japanese version), you must use quoted identifiers.
596709 (84595)
The « and » characters are not supported in Simplified Chinese. Therefore, when you add a shape to the drawing surface, the name in the Model Explorer is prefixed by two question marks (??). Two question marks are added with each subsequent edit of the name as well.
596711 (84598),
600275 (83441)
Copying a model in the Navigator window does not work for the following languages: Japanese, Korean, and Chinese.
Java
231328
This release of XDE upgrades the Java Runtime Environment from that used in previous releases. If you experience problems compiling an existing project after upgrading, please check Preferences > Java > Installed JREs and verify that it points to a valid installed JRE.
J2EE
229696

Various J2EE server properties, such as EJBResourceRef and WebResourceRef, have a tag editor with a field for a password. While the tag editor obscures the password on the screen by using an echo character, the password itself is still saved in the model as plain text; it is not encrypted.

Workaround: Do not save sensitive passwords in these tags. Use the java.security package to encrypt the password.

232813
When you are using XDE integrated with WebSphere Studio Application Developer, and you are using the Mapping Editor to associate CMP fields to database table columns, close the editor before you add, remove, or modify CMP fields using XDE. After modifying the CMP fields, reopen the Mapping Editor and regenerate the mapping to get the changed fields mapped properly.
232859

Classpath for WebSphere deployment only allows JARs: When deploying to IBM WebSphere Application Server, a classpath is passed to the WebSphere deployment tools. However, these tools only read the JARs in the classpath; they ignore any directories. This means that if you have an EJB project with references to other projects; for example, a Web project, and classes in the referenced project are used by the EJBs, then deployment may fail.

Workaround: Put the compiled objects in the EJB project or create a JAR of the referenced project and add it to the classpath of the EJB project.

234413

When running XDE inside WebSphere Studio Application Developer (or other IDEs in the WebSphere family) on versions of Windows older than Windows XP, J2EE deployment may fail with the following Output messages:

[ J2EE : 2002-12-18 16:08:19 ] [Error Stream] The input line is too long.
[ J2EE : 2002-12-18 16:08:19 ] [Error Stream] The syntax of the command is incorrect.

This indicates that the classpath used during deployment is too long. Deployment uses .bat files provided by the server vendors and a command-line cannot exceed the 255-character limit. This will happen if the classpath is too long.

Workaround: Application Developer adds many unnecessary JARs to the classpath. In the Navigator, select the project and click Properties on the shortcut menu. Click Java Build Path and the Libraries tab. Remove all the WAS_50_PLUGINDIR/... JARs, except for j2ee.jar.

234707

When creating CMP fields in EJBs on an EJB diagram, the abstract CMP get/set methods will appear in the bean class and then quickly disappear. (This is caused by the filtering performed on EJB diagrams.) At this point, if you invoke "undo", the get/set methods will simply reappear. A second "undo" is necessary to actually remove the new CMP field. The same behavior happens when creating similar elements, such as Primary Key Fields.

Workaround: Use "undo" twice to fully remove the newly created items.

237109

When you repeatedly run the Deployment Wizard to set up deployment models, it will not remove items that were added to a deployment model during a previous invocation of the wizard. Clearing those items in the wizard does not remove them from the deployment model.

Workaround: Manually remove the «JARinclude» relationships connecting the obsolete items to the archives (EJB-JAR, WAR, etc.).

239146

Attributes of a class can also be modeled as associations. However, if you transform a class to an Entity EJB, any associations are ignored; they are not mapped to BMP/CMP fields.

Workaround: Convert the association to an attribute before transforming to an EJB.

239915

When you delete an EJB in the IBM WebSphere Studio Application Developer J2EE perspective and save the changes, XDE does not delete it from the EJB Deployment Model if the model is closed, even though XDE opens the model automatically. Errors are reported in the console window.

Workaround: Keep the EJB Deployment Model open when making changes in the J2EE perspective.

240508

Due to a defect in the JSP Compilation Validator in version 5.0.1 of IBM WebSphere Studio Application Developer, you may experience serious problems with various Rational XDE features. If you code-generate a ServerPage in XDE or edit and save a JSP in the editor, certain features will fail, including Add Java > EJB, Add Java > Servlet, and pattern expansions.

Workaround: Download and install the update for Application Developer, "Websphere Studio Application Developer Interim Fix 001." You can use the Update Manager (click Help > Software Updates > Update Manager) or the WebSphere Studio Application Developer downloads site.

594853

When deploying to the Sun J2EE Reference Implementation, the deployment generates the data types for SQL statements from the EJB model, not from any mapped data models. Limited name changes are supported using the EJB mappings to data models since the Sun RI processes the fields in alphabetical order. Also, the tables generated for one-to-many relationships in the Sun RI do not match the XDE transformations.

Workaround: Based on these limitations, users should normally not expect to use the result of the EJB to Data Model feature during deployment to Sun RI.

597953

If you are using XDE integrated with WebSphere Studio Application Developer, you are not permitted to create EJBs in the "root" package, named "ejbModule". However, in some cases, XDE allows you to create EJBs in this package. For example, transforming a database table to an EJB will allow you to select the root package for the new EJBs.

Workaround: Always put EJBs in a subpackage.

Patterns and Code Templates
36558

Abstract Factory Java needs createConcreteProduct to be create<%=ConcreteProduct%>.

Workaround: Apply the pattern with default values, then rename the participants as needed.

47714

A pattern can have a template parameter of Unified Modeling Language (UML) Type Association and also contain Associations with the same names in the pattern’s Root Context. When the pattern is expanded, the Root Context’s Associations are correctly replaced with the template argument values in the target area, but validation errors are reported.

Workaround: In the Pattern Explorer, set the merge behavior on the template parameter’s Association Type element to Replace. However, a side-effect of the workaround is that the associations are duplicated when the pattern is reapplied.

49666,
232776

Facade Pattern: The first operation is not generated when apply multiple operation participants. Workaround: Apply the Facade pattern binding only one operation at a time.

50679

After a user applies a pattern that has a COM Callout or expands a COM Code Template, either in preview mode or in expansion/code generation mode, any modifications to the COM .dll file are not recognized.

Workaround: Modify the file as needed and then shut down or restart Rational XDE.

50899

When a user clicks Cancel in the Apply Pattern Wizard or the Apply Pattern dialog box, a dialog box appears to ask if the user wants to save the binding. Sometimes the binding is saved when No is selected.

Workaround: Perform an undo operation or delete the added binding.

50964

If two developers each add a code template to the same method contained in a configuration-management-controlled model, the code templates can be checked in but not merged. Only one of the code templates can be merged and the other must be re-bound.

Workaround: Do not allow parallel addition of code templates to the same model elements.

51293, 135029

For models under configuration-management control, adding more than 16 code templates to the same model may cause the 17th element to appear twice in the element’s bindings when the model is checked-in and merged.

Workaround: Do not bind more than 16 code templates to a CM controlled model element if the model can potentially be merged.

58765

When applying the Iterator Pattern with selected values, errors will occur in the code.

Workaround: Apply the Iterator Pattern with default values, then rename the participants as needed.

134833

The Pattern Explorer's Update Toolbox button does not update the properties for patterns that already appear in the Toolbox.

Workaround: To update an existing Toolbox pattern item, right-click the item in the Toolbox and click Delete. In the Pattern Explorer, click the pattern’s Toolbox node and click the Update Toolbox button in the Pattern Properties window.

134864

Reapply of a pattern does not remove elements added by a previous application of the pattern. For example, a pattern adds an operation with a scripted name, get<%=attributeParamName%>, and the first time the pattern is applied the template argument for the attributeParamName template parameter is Foo and the operation getFoo is added to the model. Then, the user changes the name of the attribute to Bar and reapplies the pattern. A new operation getBar is added, but the old getFoo is not removed.

Workaround: None.

134998

For patterns appearing in the Pattern Explorer and owned by models under configuration-management control, canceling a related checkout may cause the Pattern Explorer to be in an inconsistent state.

Workaround: Close the pattern in the Pattern Explorer and then reopen it.

135007

Most pattern callouts and constraints, when applicable, correctly add error messages to the Output window and an error message box. However, a few messages are instead added to the Task window.

Workaround: None for constraints. For callouts, add messages and specify that they appear in the output window.

135112

Specifying a custom default binding location for all new models in the Preferences or Options dialog box prohibits the creation of any new models.

Workaround: Specify the custom default binding location on a per model basis: Create a new model, and then set the default binding location for that model.

135133

Changes made to patterns properties (such as Expansion Enabled or Expand Nested Bindings) in the Properties window do not always update in the Pattern Properties window.

Workaround: Close and re-open the pattern in the Pattern Explorer.

135205

When upgrading models to this release, the ownership of the first generated or added URL linked to each nested bound collaboration changes. Ownership of the link transfers to the «Asset» package that owns the nested bound collaboration. Other URLs owned by the nested bound collaboration are not changed.

Workaround: Delete any URLs owned by bound collaborations before upgrading the model and manually add them back afterwards.

237480

Some patterns and code template dialog boxes can display intermittent sizing problems, where a subcomponent of the dialog box becomes relatively smaller than the other components.

Workaround: These sizing problems can usually be corrected by resizing the internal components, by dragging the internal sash next to the component. Often, resizing the entire dialog box will also cause the internal components to resize correctly.

237735

View elements created by application of a pattern may duplicate on reapplication of that pattern.

Workaround: In the Pattern Explorer, set the merge hint on the diagram to Replace or Preserve to discard the existing diagram and create a new one or keep the existing one and add a new one (respectively), instead of trying to merge in changes.

595148

Diagrams included in the Root Context may contain elements that are duplicated in the target area diagram as a result of reapplying the pattern.

Workaround: In the Pattern Explorer, set the merge hint on the diagram to Replace or Preserve. The replace behavior discards the existing target diagram and replaces it with the pattern diagram. The preserve behavior adds an additional diagram to the target area.

RXE (Patterns and Code Templates)
50209

The pattern PostApply callout's lookupParameterValue() method does not work as expected in Visual Basic.

Workaround: None.

51246

RXE elements do not form an inheritance hierarchy of types. For example, an RXE collaboration is not an RXE element. Some RXE documentation may be misleading when referencing these concepts.

Workaround: None.

51451

The RXE pattern’s isAborted() method does not return True when the pattern is being aborted.

Workaround: The pattern callout designer can call getNextAction() and use that result to determine the pattern status.

134740

As designed, the OnArgumentValue callout is invoked each time the user selects an argument value in the apply pattern tools. When the OnArgumentValue callout rejects the selected argument value, it is not added as an argument value for the template parameter. However, using OnArgumentValue does not consider the existing set of values to determine whether to add a new element to that set.

Workaround: Eliminate unwanted elements later in the pattern application by adding another callout, such as a PreExpand callout.

134745

When invoked during an OnArgumentValue callout, the lookupParameterValue() operation only retrieves the argument values for the current template parameter. Thus, pattern designers cannot filter out values for a specific parameter by comparing the values assigned to a different parameter.

Workaround: Add another callout to filter elements later in the pattern application process, such as adding a PreExpand callout.

134761

When an OnBind callout or constraint fails, the pattern designer’s failure message text correctly appears in the Output window. However, the designer’s text fails to appear in the error message dialog box that opens when using the Apply Pattern dialog box. No error message appears when using the Apply Pattern Wizard. The Apply button is enabled in the Apply Pattern dialog box even though the OnBind evaluation has failed.

Workaround: None.

134969

When a pattern is applied from a bound collaboration, the OnBind and WizardStartUp callouts cannot use the RXE lookupParameterValues() operation for argument value selection.

Workaround: Pattern designers can use PreExpand or another extension point that is invoked subsequent to the OnBind and WizardStartUp extension points to either abort the pattern or filter elements from the expansion set.

134967

In a pattern callout, the RXE lookupParameterValues() method only returns values that are associated with existing model elements. Because Generated elements have not been created at the PreApply extension point, their values are not available to the callout.

Workaround: None.

135180

Unable to successfully specify the name value for a Generated element in a PreApply callout. Without the name value, generated elements cannot be created.

Workaround: None.

Visual Trace
135408

The IBM Java Runtime Environment (JRE) that ships with the IBM WebSphere Studio Application Developer platforms does not provide the ability to use Visual Trace when running in debug mode. As a result, users of the Rational XDE Developer Plus for Java Platform Edition who engage Visual Trace will not produce a trace sequence diagram when J2SE applications are run in debug mode.

Workaround: An updated version of the JRE is included with the XDE product media. For installation instructions, see the related "Installation Issues" note under IBM WebSphere Products.

237625

You may see error messages about Visual Trace failing to load when starting Rational XDE Developer Plus for Java Platform Edition after an upgrade from Rational XDE Developer - Java Platform Edition.

If you are performing this upgrade, be sure to accept all pending updates listed in the Configuration Changes dialog box and ignore the two error messages. This will update the workspace and permit Visual Trace to load successfully in XDE.

If you do not accept the listed updates at that point, you can access the update later by clicking Help > Software Updates > Pending Changes. Please contact Software Support if you need further information.

241395
If you are using the Rational PurifyPlus or Visual Trace features to observe a program running under Microsoft .NET Framework 1.1, the observed program may crash with an "uncaught exception" message. If the error message refers to a library called BCIEngCOR.dll and includes the error code number 0x80000003 or the words "user breakpoint," then this error is caused by a known .NET Framework defect.

Workaround: Download and install the hot fix for Rational XDE Developer Plus, "Rational XDE Developer Plus Patch 1," from http://www.ibm.com/software/rational/support/upgrades/patches.html. Note that this fix can also be applied to Rational PurifyPlus for Windows, Rational Purify for Windows, Rational Quantify for Windows, and Rational PureCoverage for Windows.

513464
Lifelines in Trace Sequence Diagram that do not have any messages to or from them, as a result of post-filtering operations, will not be included on a sequence diagram created through the Generate Sequence Diagram operation.
Web Publishing and Reporting
(85508) , 597125

You cannot display published models using UNC paths. The Java tree will not load as expected.

Workaround: Map a network drive to the remote machine to view it from a remote system or copy the published model to a local machine to view it locally.

(87410), (87819) , 598009, 598224
Hotspots are created in Generated Reports as well as in Published sites. These report hot spots are incorrect and link to nonexistent files. The generated report will, however, display and print correctly.
(87752), (87858), 598186, 598244
Hotspots are currently not supported on activities contained within swimlanes.
373221

If you have installed both Rational Suites and Rational XDE, uninstalling either product will result in failed graphics support for reporting, including diagrams.

Workaround: Reinstalling the product that was removed will resolve this limitation.

374053

If you use Netscape 6.0 as your default browser, and you generate a report or publish a model with the option to "open ... upon completion," Netscape opens behind other windows.

Workaround: Bring the Netscape window to the front by clicking in the status line or by using Alt+Tab. Alternatively, set Internet Explorer as your default browser.

General XDE
(29312, 55125, 77420)

Mnemonic keys (ALT+<key>) do not work in the Preferences window or in the Find/Replace output window.

Workaround: Use Tab and Shift+Tab to navigate to the desired button or field.

43822

Saving models with very long names can lead to problems. The limitations have to do with the Windows limitation of 256 characters for fully qualified path names. To avoid problems,
users should avoid saving models with file names long enough to make the entire path name
longer than 256 characters. Note that, in addition to the saved .mdx file, other support files may be
created that contain additional characters that will add to the overall path length--for example, the .idx file has an additional 31 characters added.

Workaround: Ensure that your path names do not approach the 256-character limitation.

(57053), (26760), (26931)
Rational XDE will not print dashed lines correctly on some printers. This is noticeable for UML dependencies and messages.
(71118)

When the zoom factor for a sequence diagram is set to 75% or 50%, you may encounter auto-sizing issues with the box at the top of a lifeline. A long name will appear elided in the box, rather than the box auto-sizing to accommodate the text.

Workaround: Adjust the zoom factor slightly and the box will correctly auto-size.

(72662)

Rational XDE does not always detect file system changes within the Eclipse project spaces when those changes result from actions performed outside of Eclipse. For example, file changes resulting from the use of an external editor (whether started from within XDE or not) are not automatically detected. However, changes that are made using the internal editors (model changes or changes to Java files using the internal Java editor) will be detected and processed.

Workaround: You can force Eclipse to recognize the changes by right-clicking the project in the Navigator and clicking Refresh.

(73746), (73381)

When copying diagram contents across Windows Terminal Server or Remote Desktop Connection to a local application, such as Microsoft Word, portions of the shapes and connectors are missing in the pasted image.

(77069, 77219, 83365, 84240, 84569)
You cannot open models by double-clicking on their files outside of XDE.
134718

When you first open models that were created with a prior version of XDE, you are notified an upgrade is required. Once you dismiss the prompt and the upgrade process begins, XDE does not indicate the progress of the upgrade. Depending on your processor speed, available memory, model size, and number of storage units (files), upgrades can take several minutes. Large models can take up to 20 minutes in some cases.

Workaround: Plan in advance for a long, one-time process and wait for it to complete.

217562 (28247)
To be able to open an .rtf file after the file has been added to Rational XDE, you must edit the path name to the shell's Open command for the .rtf file. The path name must be enclosed in quotes.
227795 (78248)

Some Rational XDE operations are case-sensitive, which can lead to errors or problems with model dependencies. For example, if you delete a project and then re-create the project using the same name, but not the same case, the dependencies between models are lost.

Workaround: Use consistent capitalization when naming projects to prevent such problems.

231615

When XDE for .NET and XDE for Java are both installed on the same system, attempting to open an XDE model in the Eclipse Navigator with the system editor may cause a "lock" problem.

  1. Start XDE and create a model.
  2. Close the model.
  3. In the Navigator, right-click the model you created and click Open With > System Editor.

The follow error message appears: "Another session is already running in the associated workspace. If this is not the case, please delete the “.lock” file in the workspace “.metadata” directory and try starting the platform again." To proceed, you need to follow the instructions in the message.

238645
When merging two versions of a model, changes to association ends are not resolved using a consistent contributor. For example, if one version of the association has multiplicies on the two ends of "1,1" and the other version has "M,N", then the merged result could be "1,N" or "M,1".
239534

You can upgrade models created with previous versions of Rational XDE to Rational XDE version 2003. Before you begin the model upgrade process, verify that the read-only attribute is not set on any model files participating in the model upgrade process. For more information, see Rational XDE Help on upgrading models.

241946
You may encounter an error after disconnecting from a mapped network.

Steps to reproduce:

  1. Map to a network drive.
  2. Open a Rational XDE model on the network drive.
  3. Exit the model without saving it.
  4. Disconnect from the network drive.
  5. Open XDE and create a new project on a local drive.
    You receive an error informing you that the network drive cannot be found.

Workaround: Reconnect to the previously mapped network drive.

513806
The online Help Synchronize command will not work if you invoke it from a user-interface reference topic. Because these topics are not part of the user-visible table of contents, you cannot synchronize from these files. Attempting to do so will result in the following error being displayed: "Synchronization cannot be performed. The current document displayed does not exist in the table of contents."
514429

When moving a model with unsaved changes in Navigator from one project to another, the shell detects that the model is changed and reverts the operation. In the process of reverting the operation, the storage units are deleted in the original project, although they remain in the destination project.

Workaround: Avoid this situation by saving all changes before moving a model.

589837 (56712)

Changing line style of connector from oblique to rectilinear is not always optimal if the oblique line contains only right angles. Changing line style from oblique to rectilinear can reroute the connector, even when the line consists only of right angles. The line routing optimizes for shortest path and will reroute complex right-angled routings when performing the conversion.

Workaround: Manually adjust line routing to suit.

590299 (61999)
Rational XDE creates message connectors in a sequence diagram using the oblique style. Do not manually change the line style to rectilinear as the layout results are unpredictable.
592401 (75906)
When a call event is set with a reference operation (by dragging and dropping an operation onto a transition), the event name shown on the drawing surface or the Model Explorer is the reference operation name; the actual event name is displayed in the Property window. If the reference operation's name changes, the call event's displayed name in the drawing surface and Model Explorer also changes accordingly.
592414 (75944)

If you open a template model (for example, visualmodel.mdx or GettingStarted.mdx) directly from Windows Explorer, the file is immediately updated as a non-template model. Any models created from a template that was opened in this way will have the same model identifier (GUID), which will cause failures with certain cross-model references.

Workaround: Do not open template models in Windows Explorer. If you have already done so, reinstall the template model from the product CD.

596868 (84956)
There is no message on upgrade/save of read-only models. Because the models are being converted to a new version, a new file is being created. If you want to preserve the original read-only status, create a backup or set the converted file’s property to read-only.
598190 (87203, 87762)

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.

Defects Fixed in this Release

The following table describes the defects fixed in this release. It lists all fixes in Rational XDE Version 2003.06.16, version 2003.06.15, version 2003.06.14, version 2003.06.13, version 2003.06.12, version 2003.06.01, version 2003.06.10 (Japanese), and version 2003.06.00 (English).

Category

ID

Description

Compare/Merge
238097

If you attempt to use the Compare With > Each Other menu command when all of the resources selected in the Navigator are XDE artifacts, the shell will appear to hang. The operation may finally complete, provided you have adequate physical/virtual memory, but it may take hours or days to run.

239447

If you end a ClearCase-initiated merge session by clicking the Close button, you may see five error messages. To avoid this, please follow the recommended procedure for ending a merge session, which is to use the File > Compare/Merge menu instead of the Close button.

513643

 

When working with XDE, two users may create storage units with the same name in their versions of the same directory. When the users attempt to check in or deliver their work and a merge is triggered, ClearCase will prompt the user to choose between the two storage units and XDE Compare/Merge will independently ask the user to choose between the two model elements associated with those storage units. In this situation, it is important that you choose consistently. That is, if you choose one user's storage unit, then you should also choose that user's model element associated with that storage unit. For example, suppose both users created class1 as a separate unit in a file named class1.clx in their versions of the same directory. The ClearCase directory merge will ask which of the two class1.clx files should be present in the merged directory and XDE Compare/Merge will ask which of the two class1 model elements to present in the merged model. If the user chooses the first user's class1.clx file during the ClearCase directory merge, then the user should also choose that user's class1 model element during the XDE Compare/Merge session.

Note that if the model element names differ but the storage units are the same, a similar situation arises but the behavior differs. For example, both users might initially create class1 in storage units class1.clx in their versions of the same directory. Then, the first user renames the class1 model element to be myclass. The storage unit retains the name class1.clx. However, in this case XDE Compare/Merge will allow both model elements class1 and myclass into the merge result model even though the ClearCase directory merge will permit only one class1.clx to reside in the directory. The resulting model will be unable to locate the missing storage unit. To recover from this, you should rename the missing class1.clx file to some other name and then locate this renamed file using the Browse to Unit command on the shortcut menu for the model element that is missing its unit. Perform the rename using the ClearCase Explorer or at a cleartool command line so that the history of the renamed file (which includes the file with its original name) is preserved.

513872

The following defect only applies to the Rational XDE Developer - Java Platform Edition: A ClearCase-initiated merge session will fail while comparing or merging two interaction instance units (*.iix), containing at least one lifeline, with each other.

Configuration Management
239403

When opening a read-only (for example, controlled and checked-in) model created using a previous release of XDE for the first time, and the model is a non-Java Code Model with the Java profile applied, you will see the following error message in the output log:

Error: Exception in MU.doTaggedValues(NME): 
The Operation attempted to modify a read-only element

This error is benign and can be safely ignored. After continuing with the upgrade of the model and saving it, you should not see this error again.

239945

Users who go off-network will not be presented with the view chooser when using the Rational XDE
in ClearCase view
command from the Start menu. Instead, users will be launched into the default workspace for XDE that is used for the non-ClearCase view Start menu command.

239946
Users who created cross-model references that resolve through XDE version 2002, Release 2.1 Service Release VOB-root registered locations must use a snapshot view the very first time these models are opened in XDE version 2003.06.00 or later, which will result in these models being upgraded. Once the models are upgraded and checked in, the models can be accessed in a ClearCase dynamic view.
240185

Opening a model containing cross-model references in a ClearCase dynamic view may result in the following behavior: Any models that are opened in the process of resolving the cross-model references are not shown as being under source control in the Model Explorer (they do indicate as being source-controlled in the Navigator).

246156

It is possible for newer versions of a model to be loaded during a rebase, update, or deliver operation; therefore, we recommend that the user do the following when performing one of these operations:

  1. Save any unsaved changes.
  2. Perform the operation (rebase, update, or deliver).
  3. In the Model Explorer, click the Reload All Models button.
513516, 513549
When changes are made quickly during a rebase, the reload prompt will not appear. If you quickly move between a model check-in and a rebase (that is, in less than a minute), this may result in a situation where the software does not recognize that a change had been made.

Steps to reproduce the problem:

  1. User1 creates a basic modeling project in a UCM snapshot view.
  2. User1 adds the project and the model to source control.
  3. User1 delivers the changes to the default integration stream.
  4. User1 creates a new baseline.
  5. User2 rebases to the new baseline.
  6. User1 makes changes to the model.
  7. User1 checks in the model changes.
  8. User1 delivers the changes to the default integration stream.
  9. User1 creates a new baseline.
  10. User2 opens the project and the model in the shell.
  11. User2 rebases to the new baseline from the ClearCase menu in the shell.

When steps 2 through 7 occur in less than a minute, the described problem occurs. However, such a scenario is rare and would require unusual speed and coordination.

514052

When a user tries to add newly created and unsaved storage units to source control, the storage units may not be listed in the Add to Source Control dialog box. This issue arises if Do Nothing is selected for the team/Rational ClearCase preference setting When new resources are added.

Data Modeler
241098

If you have no existing data model, the Class to Table Transformation dialog box does not open when you use the Class to Table command on the Transform menu.

241752

Creating new triggers for a table or view will cause an exception if the name of the respective table or view is less than 3 characters in length.

Documentation
242208

The online Help for Data Modeling states that you can assign a domain to an attribute in a logical data model. This functionality is not supported.

246175

See the description for defect 246175 below, in the "General XDE" section of this table.

375451
The Help for Visual Trace should include the following text: "You must engage Visual Trace before starting the application to be traced."
598017

Obsolete documentation for Adding Template Arguments for Template Parameters
Installing and Uninstalling
239910
After you import a Rational Rose model (*.mdl) to a Rational XDE model (*.mdx), immediately save the imported model to the XDE file format. If you attempt to modify the model without first saving it as an XDE model, and then select Cancel from the Save As dialog box, the model will be closed without saving the changes to the model.
447417
The following issue only applies to the Rational XDE Developer Plus Edition: To correctly configure a SitePrep area for XDE, Rational recommends that you do not use SitePrep.exe directly. Use Setup.exe and select Enterprise Install mode to create the SitePrep area. If you use SitePrep.exe directly, the SitePrep area may not be properly configured and an install performed from the improperly configured area may hang.
Internationalization
240169, 240232
XDE cannot be installed into a path that includes Japanese or double-byte characters.
453121/APAR IC38562

If a file is updated during code generation, a space is appended to the end of the file for each Japanese character in the file. This happens every time the file is updated on code generation.

453933
The XDE-supplied file RASRepositoryService-portable.war, provided as part of the J2EE RAS Repository, does not support internationalization requirements. When you create a J2EE-type repository service with this file, any Japanese characters in the assets owned by the repository will display as question marks (?) in XDE.
593705

Publishing a model to a folder that has double-byte characters in the name causes the tree control to fail in the published model.

596710 (84596),
600794 (65872)
When exporting a Rational XDE model as a template on a Japanese operating system, do not include special characters or double-byte characters in template descriptions or names, or the template will not appear in the list of available templates. Note that the file will still be saved in your file system.
Java
22219 (67134)
When synchronizing a Java class with multiple levels of nested (inner) classes while the Eclipse automatic recompilation feature is enabled, you may receive a message caused by a bad interaction with the compilation system.
49893
When automatic synchronization is enabled, XDE will synchronize a project's Java code model to any changes you make to the project's .java files. If you make a change when the code model is closed, it will be opened and the XDE Model Explorer view will get focus. For instance, you are in the Navigator view and you delete a .java file from a project whose code model is closed. The model is opened in the Model Explorer, which will take focus away from the Navigator.
134804
The project name is not displayed when creating a Java modeling project for the first time in the Model Explorer. The project name only appears after performing any Java action such as creating a Java element or synchronizing source code and the model.
245085/APAR IC38424

If two packages contain a class with the same name and you attempt to move one of the classes into the package with the conflicting class by changing its package statement and then synchronizing (or if you perform this change with autosync enabled), the move of the class will fail. At the point of failure, the output log will indicate that there was a failure to rename the class. The Model Explorer will then show a new class and component with "_1" appended to the name. In addition, you will see a component with "_1" appended after ".java".

589683 (54005)
The UML Subsystem element is not supported in Java code models. Its use will cause errors during round-trip engineering.
590081 (59676)
Java round-trip engineering may have trouble with the formatting of Javadoc or other comments that are reverse engineered from source that has been maintained in a Unix development environment.
590683 (65975)
If you are using Java round-trip engineering, and you use the Navigator view to rename a file-system folder that corresponds to a Java model package, the corresponding source-code package statements and model package elements are not automatically updated.
592065 (74682)
The Assistant dialog box for adding a Bean property does not prevent you from using long, double, or float as the type expression when you specify a constrained property.
593115 (77777)
If the Model Explorer view is closed and you reverse engineer a code file by right-clicking the file in the Navigator view, the Model Explorer view may not open.
J2EE
234444

When modeling J2EE applications, use separate projects and code models to model EJB, Web, and client components, including clients used to test one of the other "tiers." (Note that WebSphere Studio Application Developer forces you to use this structure.) By default, when you create deployment models, they automatically get «JARinclude» relationships to the corresponding code models. This step conveniently associates the components to the corresponding JAR. However, if you have servlets and EJBs in the same code model, all of them will get included in the EJB-JAR and WAR that you create. This is a problem when you deploy both tiers to the same machine. Many application servers use the same classpath for both tiers. So, for example, when you invoke a servlet, you may get the servlet located in the EJB-JAR and not the servlet in the WAR. This is especially confusing if the servlet has changed since you last built and deployed the EJB-JAR.

237932
When you reverse engineer an EJB or Web deployment descriptor, some relationships between elements on existing diagrams may be inappropriately deleted from the diagram. To restore a missing relationship, remove one of the two "end" elements from the diagram (do not remove it from the model), and then add it back to the diagram by dragging it from the Model Explorer. This step will redraw the line. For EJB diagrams, the shortcut menu command Customize EJB Diagram can also be used to restore these lines.
239887, 229151, 239854

In some scenarios, the method filtering in EJB diagrams does not work as expected.

  • You add a CMP 2.0 field and the corresponding get/set methods are not filtered. Workaround: Delete the class from the diagram (not the model), and then drag and drop it from the Mode Explorer back on the diagram.
  • In the diagram preferences (right-click, and then click Customize EJB Diagram), if you clear a type of method (meaning you want it filtered from view), then add a method of that type to the bean. The method is shown in the diagram anyway. Workaround: Open the Preferences dialog box and reset the desired filter settings.
  • In the dialog preferences, if you clear all the types of methods that are currently shown in
    one or more beans, meaning that the method compartments in those beans should become empty, instead all the methods are shown in those beans. (Other beans show the expected filtering.) Workaround: Open the shape preferences for each bean filtered in error and click OK.
239960

The J2EE patterns code templates that are inserted for method bodies are not marked "first-time-only expansion." Hence, every time you synchronize or forward engineer, the code template will be inserted, replacing any code that you added after creating the EJB, servlet, etc. This causes problems for methods that you must change manually.

240216, 240229
Saving in the J2EE perspective deployment descriptor editor or importing ejb-jar.xml deployment descriptors can result in corrupted EJB Relationships in XDE under certain circumstances. If the name of the CMR field ("cmr-field-name" in the descriptor) is the same as the name of the relationship role on the other end of the relationship ("ejb-relationship-role-name"), then XDE will corrupt the relationship, requiring that it be deleted and recreated. This duplication in naming is the default for CMRs that are in upgraded models from earlier releases of XDE. When creating CMRs in XDE and WebSphere Studio Application Developer, both use different names for these elements by default. However, if you explicitly use the same name, the problem will occur.
243758

When using Rational XDE with IBM WebSphere Studio Application Developer 5.0.x and synchronizing a Run As security role in the EJB deployment model, the role is not updated in Application Developer.

Patterns and Code Templates
57755

Facade Pattern : Duplicate return type.

135407

Bindings of external code templates in models from earlier versions of the product are not being upgraded correctly. After model upgrade, the external code template bindings are still functional in the upgraded model; however, the bindings are no longer suitable for use in situations where the path from the model to the external code template needs to be indirect. Typical situations where this occurs would be when a model is under configuration management and different users view the code template using different paths, or when the code template binding is copied from one model to another via using a pattern application.

RequisitePro Integration
59126, 238444
Using the Rational RequisitePro-XDE integration caused JVM error messages when closing Rational XDE.
RXE
239228

For generalization, dependencies and realizations, the methods/properties to access the end elements return the opposite end. Specifically:

  • IRXEGeneralization.SuperElement returns SubElement
  • IRXEGeneralization.SubElement returns SuperElement
  • IRXEDependency.SupplierElement returns ClientElement
  • IRXEDependency.ClientElement returns SupplierElement
  • IRXERealization.SpecificationElement returns ImplementationElement
  • IRXERealization.ImplementationElement returns SpecificationElement
240004

The methods IRXEReference.Resolve() and IRXEReference.getRefModel() always return Null. A call to resolve() will resolve a reference, if possible, but it will still return Null.

240020, 240024

The RXE documentation for Rational XDE Developer - Java Platform Edition is now more complete and includes the following:

  • "Extracting Properties Shown in the Property Editor" topic
  • Correct introductory paragraph for the "Java Sample" topic
  • Additional paragraph appended to the "Converting RXE Objects Between Types" topic
RXE (Patterns and Code Templates)
51254

When called from a patterns OnBind callout, the RXE pattern’s getPatternInstance() method returns null when it should return the pattern instance.

51339

The operation getRXE() fails in the Visual Basic PreExpand callout. It may also fail in other Visual Basic RXE callouts.

51437

In pattern callouts related to the use of the Apply Pattern Wizard and Apply Pattern dialog box, the
RXE’s getRXE() method does not return the correct value. This method is used to acquire the
RXE application that can be used, for example, to write to the Output window.

134788

Unable to successfully query for the Type value of the CTArgumentValue in a pattern callout so the callout fails.

134973

A pattern’s template parameters can have both a collection value source and a user value source. Patterns with both value sources and only user argument values (no collection values are generated), cause a callout’s RXE lookupParameterValues() method to incorrectly return null. Expected return is an array of CTArgumentValueHolders containing the user-entered values.

135069

 

In the Patterns OnBind callout, getThisElement() should return the pattern template because that is the element to which the OnBind callout is attached (the pattern template "owns" the onBind callout). Unfortunately, getThisElement() is returning the model in which the bound collaboration (pattern instance) is located.

Visual Trace
137862
IBM WebSphere Studio Application Developer crashes when IBM Rational XDE is being used to try to display a sequence diagram from a trace of an application that contains a very long method signature of more than 1,000 characters.
241144
Visual Trace will cause Rational XDE to terminate at the start of a debug/run session if XDE is installed into a directory that contains Japanese or double-byte characters in the name.

447942

Visual Trace is not always able to differentiate between applications launched by a user and other processes started as a result of an IDE action. This can result in Visual Trace attempting to trace processes unintentionally and displaying the following warning: "Visual Trace supports only tracing one application at a time. Please stop all other applications being traced and restart the application."

514577

The following defect is now associated with solution 187450534. Please refer to this number when calling technical support for additional information.

Visual Trace uses a socket to connect to the application being traced. If a connection cannot be established, the following warning is displayed: "Visual Trace could not establish a socket connection with target."

Web Publishing and Reporting
(71502), (79902), (85797), (85867), 591378, 594158, 597257, 597295
The publishing function requires the Java Plug-in. The Java Plug-in is not included in the Rational XDE installation.
(84246), (86198), 596528, 597457

A model element name that contains a single quote (‘) is truncated at that single quote in the published model tree.

(85176), (86419) , 596972, 597557

In rare cases, when you publish multiple models successively, you may get the following message, which prevents you from performing any further actions in the model: "A read action is open on behalf of client ‘RSE Client’."

(87286), (87521) , 597948, 598061

The Getting Started sample model file may not publish completely when published more than once during the same Rational XDE session.

(87337), (87519) , 597968, 598060

If a user name contains an extended character, a path error occurs. This prevents successful publishing and reporting of models and results in the following message: "ParameterFile.txt\ProjectConsole.ini does not exist."

241330

If you are using an installation of Rational XDE that was installed by another user, you may be prompted to install additional components when you attempt to publish a model. The suggested installation is unnecessary; you should click Cancel. Publishing will then proceed normally.

If you allow the process to finish by not clicking Cancel, a second dialog box appears that suggests a restart. You should click No. If you click OK, XDE restarts and the published model is incomplete.

372979

In a published model, displays that rely on a relationship with a MessageEnd object fail. These failures include:

  • A sender/receiver table.
  • Sequence elements in a sequence diagram that contains a reference between an operation and a message.
374690
If you publish a model that includes global actions, those actions are not represented in the published model.
General XDE
(72003), (79300), (67501)
Known issues associated with enabling and disabling Java, and J2EE add-ins, using the Add-in Manager.
238301

The cross-model reference adornment is not displayed in the correct position in the print preview or when you paste the shape into other applications such as text editors.

238555

When you open a saved model that initiates specific internal processes to open a diagram, the model appears in the unsaved or modified state (with an asterisk next to the model name in the Model Explorer), even if you made no modifications to the model. You can safely save or discard the changes without data loss.

238740

When you work with subunits, it is recommended that you save your work by using the Save All command on the File menu. If you use the Save command (or Ctrl+S), your work may not be saved consistently.

For example, you may change one subunit, which results in changes in two other subunits. If you save only the first subunit and not the two others, the files saved on disk will be inconsistent with one another. If, instead, you use the File > Save All command, all three changed files will be saved to disk and the files on disk will be consistent with one another.

240261
When renaming a model with separate subunits, ensure that all documents currently open on the model are closed prior to the rename. If the documents are not closed first, the separate subunit links will be broken in the model.
241211

This defect shows up in two scenarios:

  • You are prompted to check out the file if you open a diagram within a source-controlled model and page breaks must be updated due to prior changes in the diagram elements. However, clicking Cancel does not dismiss the dialog box. (This happens if the Prompt for check out setting is selected on the Source Control, General page of the Preferences dialog box.)
  • Rational XDE freezes if you are working with a read-only model and the diagram that you are opening must reset the page breaks due to prior changes in the diagram elements.
241325
During the model upgrade process (especially with non-US English models), the XDE print preferences may not upgrade correctly.
241771

Users who have installed Rational XDE Developer Plus on Windows NT may find that saving a blank model assigns a Rational RequisitePro applied profile to the model.

245970

When you import a model file from Rational Rose into Rational XDE, classes that have stereotypes may become very large in the diagram window.

246137

After you use Rational SoDA to generate a report on an XDE model, you may be unable to open diagrams in XDE and you may see a variety of error messages.

246175

If you are running Rational XDE on Microsoft Windows NT, you may see the following error message when attempting to launch Extended Help from the Help menu: "Extended Help is currently not available."

514427

Changes to model subunits will be lost if a model is renamed without being saved first.

518939
If you are using Rational XDE installed into Eclipse 2.0, you may see the following issue. A redundant Save As dialog box appears when you save a model with the focus set on the diagram window.
589765 (55216)
If you use the High Contrast display option for Windows 2000 Accessibility, the cursor is not visible in Rational XDE diagrams.
594382 (82893, 80803)
In some cases, you must rename a newly created activity graph or state machine, or you must close the model that contains it, before you can delete the activity graph or state machine.

Contacting IBM Rational Software Support

The IBM software support Internet site provides you with self-help resources and electronic problem submission. The IBM Rational Software Support Home page can be found at www.ibm.com/software/rational/support.

Voice Support is available to all current contract holders by dialing a telephone number in your country (where available). For specific country phone numbers, go to www.ibm.com/planetwide.