This feature enables the migration of IBM Rational Rose models to the Unified
Modeling Language (UML) 2.0 model format supported in IBM Rational Software
Architect and IBM Rational Software Modeler.
To view the latest version of this readme file, go to this Web address:
www3.software.ibm.com/ibmdl/pub/software/rationalsdp/rsa/60/html/rmi/readme.html
The Rational Rose Model Import feature provides the user with the ability to migrate, with a high degree of fidelity, their existing Rational Rose models and related artifacts into either Rational Software Modeler or Rational Software Architect.
For information about installing the Rational Rose Model Import feature, refer to the Installation instructions.
Attention: Do not cancel the installation of the feature once started.
This feature has no additional hardware requirements beyond IBM Rational Software Architect and IBM Rational Software Modeler.
This feature can be installed for use with version 6.0 of either IBM Rational Software Architect or IBM Rational Software Modeler. Before installing this feature, you must install interim fix 002 for Rational Software Architect and Rational Software Modeler.
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 "Supported Rose Petal versions" in the online help.
| 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 asssigned 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 multiline 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 accomodate 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. |
| Defect | Description |
| 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. |
| 530676 | Out of memory when comparing and merging large models with ClearCase When comparing or merging models with Rational ClearCase®, a memory leak keeps several copies of the models in memory and does not free them until the application is restarted. For small models, this has minimal impact; however, for large models, such as those generated by Rose import, the impact grows rapidly. For example, with a model in the 50 MB or greater range (size on disk), only a single merge session can be successfully completed. A second merge session will run out of memory. Note that, in order to merge such large models in the first place, the JVM parameter -Xmx should be set to provide sufficient heap space. For more information, see defect 531683. |
| 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:
|
| 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:
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 refactoring 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:
|
| 531846 | 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. Workaround: Close the Software Architect or Software Modeler workbench and launch it again. If that does not work (in rare scenarios), then it may be necessary to create a new workspace. |
| 531872 | Changes upon import of Association Classes and Generalizations When importing Association Classes and Generalizations, please note the following issues:
|
Before installing this feature, you must install interim fix 002 for Rational Software Architect and Rational Software Modeler. To find updates, click Help > Software Updates > IBM Rational Product Updater.
This feature is approximately 2.5 MB. To download and install the feature you will require approximately 5 MB of disk space.
Depending on your computer's processor speed, amount of RAM, and the speed of your Internet connection, the feature might take an extended period of time to download and install.
Attention: Do not cancel the installation of the feature once started.
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.
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. 2004, 2005. All rights reserved.
If you are viewing this information softcopy, the photographs and color illustrations may not appear.
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.
Linux is a trademark of Linus Torvalds in the United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Other company, product or service names, may trademarks or service marks of
others.