IBM Rational Rose Model Import Feature - Release notes

For IBM Rational Software Architect, Version 6.0 / IBM Rational Software Modeler, Version 6.0

© Copyright IBM Corporation 2004, 2005. All Rights Reserved.

To view the latest version of this file, see the release notes at www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rsa/60/html/rmi/readme_6001.html.

Table of contents

1.0 About this release
2.0 Installation information
   2.1 Hardware requirements
   2.2 Software requirements
3.0 Fixes in this release
4.0 Known limitations, problems, and workarounds

   4.1 Limitations
   4.2 Problems and workarounds
5.0 Contacting customer support
6.0 Notices and trademarks

1.0 About this release

The IBM® Rational Rose® Model Import feature provides users with the ability to migrate, with a high degree of fidelity, their existing Rational® Rose models and related artifacts into either IBM Rational Software Modeler or IBM Rational Software Architect.

This release includes the following updates and capabilities:

2.0 Installation information

For information about installing the Rational Rose Model Import feature, refer to the Installation instructions.

2.1 Hardware requirements

This feature has no additional hardware requirements.

2.2 Software requirements

This feature can be installed for use with version 6.0 of either Rational Software Architect or Rational Software Modeler. Before you can install this feature, you must install IBM Rational Software Architect Fix Pack 6.0.0.1 or IBM Rational Software Modeler Fix Pack 6.0.0.1.

This feature offers support for the import of Rational Rose models used in Rational Rose Version 2003.06.00 or later. This corresponds to version 8.0 or 8.1 Rose models, and petal version 47 or later. For more information, see the "Supported Rose Petal versions" help topic in the product information center.

3.0 Fixes in this release

The following fixes are included in this release of the Rational Rose Model Import feature.

Defect Description
531846 The following problem has been fixed: Exceptions indicating profiles cannot be generated or model file cannot be created

The Problems view and Log view may show exceptions indicating that profiles cannot be generated or the model file cannot be created. The internal state of the Software Architect or Software Modeler model management subsystem is corrupted.

4.0 Known limitations, problems, and workarounds

This release note includes release-specific information, such as problems and limitations that were not available until after the product documentation was finalized.

4.1 Limitations

Defect Description
530367 Same font used for association and role labels

In Rational Rose, the name label on an association can use a different font from the role labels. By default, the Rose association name label is italic and role labels are roman. In Software Architect and Software Modeler, the association has only a single font setting that is applied to all labels.

530860 Swimlane (now partition) colors are not migrated and cannot be assigned

Swimlanes (shape compartments) are transparent by default; color cannot be assigned to them. In most cases, they inherit their container's color.

530923 Labels for association role constraints missing after model import

If your Rational Rose model has associations with role constraints defined on the diagram, the constraint will be migrated but the notation on the diagram will not appear. Currently, association role constraint notation as a label attached to the association connector is not supported.

531155 State and pseudostate elements do not show stereotype icons

Stereotype icons are currently not supported by state or pseudostate elements because the default icon is basically the same as the shape image.

531520 Multiple lines of text on connector labels collapsed to a single line

If your Rose model has connector labels with multiple lines of text, the text will be imported as a single line of text because mult-iline connector labels are currently not supported. Some labels may overlap other items in the diagram editor, making the diagram difficult to read. You may need to manually arrange shape and connector views to accommodate for longer name labels.

531357 Lifelines do not show stereotype icons or decorations

Rose sequence diagrams that include lifelines with stereotyped classes and that have an associated image (a decoration) will change after import so that the lifeline appears without the stereotype image. The lifeline's class is still stereotyped, but there is no decoration of the lifeline to indicate that this is the case. Rational Software Architect and Rational Software Modeler do not support lifeline stereotype images or decoration icons.

531683 Multiple Rose controlled units copied into single model file upon import

When you import a Rose model, all controlled unit content is automatically copied into the imported model. The controlled unit no longer resides as a separate file and is incorporated into a standard, monolithic Software Architect or Software Modeler model. This is not selectable. In addition, having a single large file may cause performance problems during the import process.

Once you import your Rose model, you can break up your model into separate physical models. Creating models from each subsystem gives you the same control that you had when the subsystems were controlled units in Rose. For more information, see the online help topic "Multiple model approach versus Rose controlled units."

531873 Stereotype icon does not reflect the class that is the object's type

In Rose, an object in a Sequence diagram, Collaboration diagram, or Activity diagram shows the stereotype icon (if any) that is applied to the class that is the object's type. This is currently not supported in Software Architect or Software Modeler.

4.2 Problems and workarounds

Defect Description
142159

Using import wizard while model import is in progress results in error

If you click a button on the Rational Rose Model Import wizard once the import operation has started and the Progress Information window is open, an error will result. You need to close and restart the wizard. To stop the import operation while the Progress Information window is open, click the Cancel button in the window.

Workaround: Do not select any Rational Rose Model Import wizard buttons while the model is being imported and the Progress Information window is open.

246473 Note attachment connectors not imported

If your Rational Rose model has a note that is attached to a text element through a note attachment, the note attachment will not be imported. Note attachments are only supported from a note to a UML element.

529643 White dot appears near Node element in Rose Classic appearance style

When using the Rose Classic appearance style in Software Modeler or Software Architect, a white dot is visible on the right side of a Node element. Note that the appearance preference is set by clicking Window > Preferences, expanding Workbench, and clicking Appearance.

530615 Unexpected changes in imported Statechart diagrams

In Rational Rose, Statechart and Activity diagrams are implemented in a single state/activity model. The elements available in Activity diagrams are a superset of the Statechart diagrams. Upon importing a state/activity model, Software Architect or Software Modeler checks whether it contains any Activity diagrams or elements that can only be visualized on Activity diagrams in Rose. If so, then all of the Statechart diagrams are converted to UML Activity diagrams in the Software Architect or Software Modeler model, states are converted to structured activity nodes, and transitions are converted to control flows.

Workaround: If the conversion of Statechart diagrams to UML Activity semantics is a problem, you can separate Statechart diagrams and Activity diagrams into separate state/activity models in the Rose model before importing it. Because a package can only own a single state/activity model, this may require creating additional packages. The state/activity models containing only Statechart elements will be imported as UML state machines.

531158 Unexpected color settings for Initial State, Initial Node, Final State, and Final Node

The Statechart's Initial State and Activity's Initial Node use the LINE COLOR attribute as their colors; they ignore the FILL COLOR attribute value. The statechart's Final State and Activity's Activity Final Node (both bulls-eye style icons) set the outer circle color to the FILL COLOR attribute and inner circle color to the LINE COLOR attribute.

531394 Stereotype icons missing in imported diagrams if Rose not installed

If you install and use the Rational Rose Model Import wizard on a computer that does not have Rational Rose installed, the imported diagrams will not include the expected stereotype icons in the imported model. In addition, the list of stereotype configurations on the Map Stereotypes page of the wizard is empty.

Note: The following workaround assumes the same operating system is being used for Rose and either Software Modeler or Software Architect.

Workaround: To retain stereotype icons in diagrams, either use the same computer for Rose as well as either Sofware Modeler or Software Architect or use the following procedure to make the stereotype artifacts available during import:

  1. Export the Rose data from the Windows or MainWin registry of a machine that has Rose installed and transfer the resulting file to the computer with Software Architect or Software Modeler installed. Use the following steps to export the Rose registry keys:
    1. Use the regedit or regedt32 tool to export the following registry key:
      HKEY_CURRENT_USER\Software\Rational Software\Rose
    2. Name the file rose_user.reg.
    3. Using regedit or regedt32, export the following registry key: HKEY_LOCAL_MACHINE\SOFTWARE\Rational Software\Rose
    4. Name the file rose_local.reg.
    5. Combine the files, rose_user.reg and rose_local.reg, using one of the following methods:
      • On Windows®, from the command line, type:
        C:\> copy rose_user.reg + rose_local.reg rose.reg
      • On Windows, in Notepad, open both files, copy the contents of one to the end of the other, and save the result. Be sure to save it with the Unicode encoding, specified in the Save As window. Name the file rose.reg.
      • On Linux® or UNIX® platforms, from a command line, type:
        $ cat rose_user.reg rose_local.reg > rose.reg
  2. From the same Rose computer, copy the stereotype configuration INI files from the base Rose installation and all installed add-ins, plus all of the associated image files, to the computer that is running Software Architect or Software Modeler. Be careful to maintain the identical Rose directory structure because the registry and stereotype INI file information depends upon the same structure.
  3. In the Rational Rose Model Import wizard, specify the registry export file created in the first step in the Registry file field on the first page of the wizard.
  4. Proceed through the wizard to the Map Stereotypes page and ensure that all of the stereotype configuration files obtained in step 2 appear and are mapped to existing or new UML profiles.
  5. Finish the wizard to complete the import.
531683 Out of memory when importing large models

If you encounter an out-of-memory error when loading large Rose models, you will need to increase the heap size for the workbench JVM.

Workaround: You increase memory by passing the "-vmargs -Xmx<size>" arguments on the workbench command line. For example, to specify a 1 GB heap, assuming a typical product installation location:

  • On Windows:
    C:\Program Files\IBM\Rational\SDP\6.0\rationalsdp.exe -vmargs -Xmx1024M
  • On Linux:
    /opt/IBM/Rational/SDP/6.0/rationalsdp.bin -vmargs -Xmx1024M

For Rose models up to 50 MB in size (including all CAT files), the default JVM settings are usually sufficient. For larger models, consider increasing the heap size.

For Rose models of 50 MB or larger, consider re-factoring the model into smaller units after importing it. Packages can be extracted into separate models using the Create Model from Package command on the pop-up menu. This can help to reduce the amount of model data that is loaded in memory at one time.

531826 Incomplete import into project in dynamic ClearCase® view

When importing a Rational Rose model, if the UML model and profiles are to be created in new projects in a dynamic view in Rational ClearCase Version 6.13, then the model file will be imported, but property sets and stereotypes may fail to be converted to UML profiles. You may see an error indicating that the project in which the profiles were to be generated could not be created; for example, "Cannot create project in non-writable location: test1project_profiles."

Workaround: To use ClearCase dynamic views for imported models:

  1. Open the Rose Model Import wizard and create the model and profile projects in some location not in a ClearCase dynamic view.
  2. Continue to the next page of the wizard to import the Rose model and stereotypes.
  3. Delete the projects from the workspace (do not delete the project contents).
  4. Using Windows Explorer, move the project directories into the ClearCase dynamic view.
  5. Use the Import Existing Project into Workspace wizard to bring the projects back into the Rational Software Architect or Rational Software Modeler workspace.
531872 Changes upon import of Association Classes and Generalizations

When importing Association Classes and Generalizations, please note the following issues:

  • In Rational Rose, the dotted connectors that attach Association Classes to their Associations can be manually shaped with bendpoints. In Software Architect and Software Modeler diagrams, this attachment connector is not persisted in the diagram and is always rendered as a straight line; it cannot be manipulated by the user.
  • In Rose, Generalizations are named elements. In UML 2.0, Generalizations are not named elements, so the names of any generalizations in the Rose model that have names will not appear in the diagrams in Software Modeler or Software Architect. The original name of the generalization is stored in the Rose stereotype on the UML generalization.
  • In Rose, Associations and Association Classes are separate elements, linked together. In UML, the AssociationClass is represented as a single element. The Rose association and class may both be named, and these names may be different. When they are imported, only the name of the class is retained in the UML association class; the name of the Rose association is stored in the Rose stereotype on the UML association class.
533301 Problems when opening an imported Rose model on Linux

After importing and opening a Rational Rose model on Linux, the following problems may occur:
  • "Unable to create part" error message is displayed when attempting to open the main Use Case diagram.
  • Components in the diagram appear to be distorted
  • Rational Software Architect stops.

Workaround:  Exit Rational modeling product and restart in a new workspace.

In addition, the following information, available in the readme for Rational Application Developer Version 6.0, might be helpful:

Operations might make UML diagrams unusable

On Red Hat Enterprise Linux 3.0, certain operations might make a UML diagram unusable. In each case, the following error message is displayed:

An internal error occurred while showing an internal error. You are recommended to exit the workbench. Subsequent errors may happen and may terminate the workbench without warning. See the .log file for more details. Do you want to exit the workbench?

The .log file will contain exceptions that are similar to the following ones:

!MESSAGE Failed to execute runnable (java.lang.InternalError: Can't connect to X11window server using ':0.0' as the value of the DISPLAY variable.)

!STACK 0
org.eclipse.swt.SWTException: Failed to execute runnable (java.lang.InternalError:
Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable.)
    at org.eclipse.swt.SWT.error(Unknown Source)
    at org.eclipse.swt.SWT.error(Unknown Source)
    at org.eclipse.swt.widgets.Synchronizer.runAsyncMessages(Unknown Source)
    at org.eclipse.swt.widgets.Display.runAsyncMessages(Unknown Source)
    at org.eclipse.swt.widgets.Display.readAndDispatch(Unknown Source)
    at org.eclipse.ui.internal.Workbench.runEventLoop(Workbench.java:1377)

!MESSAGE Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable.
!STACK 0
java.lang.InternalError: Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable.
    at sun.awt.X11GraphicsEnvironment.initDisplay(Native Method)
    at sun.awt.X11GraphicsEnvironment.<clinit>(X11GraphicsEnvironment.java:175)
    at java.lang.Class.initializeImpl(Native Method)
    at java.lang.Class.initialize(Class.java:350)
    at java.lang.Class.forNameImpl(Native Method)
    at java.lang.Class.forName(Class.java:116)
    at java.awt.GraphicsEnvironment.getLocalGraphicsEnvironment(GraphicsEnvironment.java:91)
    at java.awt.image.BufferedImage.createGraphics(BufferedImage.java:1073)
    at org.apache.batik.ext.awt.image.GraphicsUtil.createGraphics(Unknown Source)
    at org.apache.batik.gvt.filter.GraphicsNodeRed8Bit.genRect(Unknown Source)
    at org.apache.batik.gvt.filter.GraphicsNodeRed8Bit.copyData(Unknown Source)
    at org.apache.batik.ext.awt.image.rendered.TileCacheRed.genRect(Unknown Source)

To work around this issue, you must exit and restart the product.

960282 Actors may not appear to be imported consistently from Rose models

When using the Rational Rose Model Import wizard, the Interpret UML 2.0 conventions in the Rose model check box on the Rational Rose Model Import Preferences page has the following impact:

  • If the check box is selected, the Rational Rose Model Import wizard will attempt to map Actors in the Rose model to UML 2.0 Actor elements, except in the following cases:
    • If the Rose Actor owns any attributes, operations, or state machines (all of which UML 2.0 Actors cannot own).
    • If the Rose Actor has a navigable association with a use case or other classifier (in UML 2.0, the Actor must own the association end in order to maintain navigability, but Actors cannot own properties).

      In these cases, the Rational Rose Model Import wizard will map the Actors as UML 2.0 classes.
  • If the check box is not selected, the Rational Rose Model Import wizard will map the Actors as UML 2.0 classes with the stereotype.

To maintain consistency, do not select this check box and all Actors will be imported as classes.

5.0 Contacting customer support 

The product home page for Rational Software Modeler is www.ibm.com/software/awdtools/modeler/swmodeler/index.html. For FAQs, lists of known problems and fixes, and other support information, visit the Support page on the product home page.

The product home page for Rational Software Architect is www.ibm.com/software/awdtools/architect/swarchitect/index.html. For FAQs, lists of known problems and fixes, and other support information, visit the Support page on the product home page.

6.0 Notices and trademarks


U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this documentation in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this documentation. The furnishing of this documentation does not give you any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

Intellectual Property Dept. for Rational Software
IBM Corporation
20 Maguire Road
Lexington, MA
02421-3112
USA

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this documentation and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples may include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrates programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM's application programming interfaces.

Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:

(C) (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. (C) Copyright IBM Corp. 2000, 2005. All rights reserved.

If you are viewing this information softcopy, the photographs and color illustrations may not appear.

Trademarks and service marks

The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:

Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both.

Intel is a trademark of Intel Corporation in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Linux is a trademark of Linus Torvalds in the United States, other countries, or both.

Other company, product or service names, may be trademarks or service marks of others.