IBM® Rational® Rose® RealTime Service Release 2003.06.13 Release Notes


Version 2003.06.13

Release Date: September 2004

Last Updated: 09/02/2004

Material ID/Part Number: GI11-6192-00


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

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

Legal Notices Information


These Release Notes are accurate at the time this product was prepared for release. The most recent version of this file is available in the IBM Publications at www.ibm.com/shop/publications/order. Search for GI11-6192-00 to find the latest version of these Release Notes in the IBM Publications Center. (To search for the IBM Publications Center, go to www.ibm.com and enter "IBM Publications Center" in the Search field.)


Scope

Product changes described in this document and contained within this service release apply to:

The Service Release Notes includes:

Getting Started

Installation Information

When you are ready to install IBM Rational Rose RealTime, be sure to check the Web for the latest available downloads:

1.       Go to  http://www.ibm.com/software/rational/support/.

2.       Then, go to the Download Center and navigate to Rational patches and service releases.

PLEASE READ FIRST

Please read the following notes before you install Rational Rose RealTime:

Reviewing the Latest version of the Release Notes and Service Release Notes

You Must Install License Keys to Run this Product

Review the Rational Rose RealTime Installation Guide for detailed instructions on how to install your license keys and how to request permanent license keys. To obtain permanent license keys, you can access AccountLink from http://www.ibm.com/software/rational/support/licensing/.

For information on contacting IBM Rational Customer Support, see Contacting IBM Rational Software Support.

Notice To Customers Running Earlier Releases of Rational Rose RealTime on Windows

You cannot run Rational Rose RealTime 2002.05.xx or earlier versions with the latest version of Rational Rose RealTime on Microsoft Windows NT, Microsoft Windows 2000, and Microsoft Windows XP Pro. You must uninstall Rational Rose RealTime 2002.05.xx and earlier versions before installing Rational Rose RealTime 2003.06.00 and/or this Service Release.

If you encounter any difficulties uninstalling previous versions of Rational Rose RealTime, refer to the Solutions document "Manually uninstalling Rose RealTime on Windows." for additional help.

What to do After Installation

The accompanying .gz or .exe files from the Service Release are no longer required. However, if you want to retain these files if a re-installation is required, you can move the tar files to <ROSERT_HOME>/specials. 

For additional information on issues with Rational Rose RealTime (prior to v2003.06.13), see the chapter, "General Issues" in the Addendum, Rational Rose RealTime located in <ROSERT_HOME>/Help/rosert_addendum_2003.pdf.

For help on the new and modified information included in this Service Release, see the Rose RealTime Release Notes, located in <ROSERT_HOME>/rosert_readme.html.

Toolset

Run the toolset and ensure that the build number is correct.  In Rational Rose RealTime, click Help > About Rational Rose RealTime and verify that the version number for Rational Rose RealTime is 6.5.825.0. If the build number is not the same, this Service Release was not applied correctly. 

Code Gen

Note: If you wish to take advantage of the problems fixed in the code generators, you need to rebuild and re-link your models.

RQA-RT

No additional steps are required.

RTJava Models

No additional steps are required.

Model Integrator 

No additional steps are required.

C++ TargetRTS

Note: If you wish to take advantage of the problems fixed in the C++ TargetRTS, you need to rebuild your Target RTS libraries and re-link your models.

C++ Models

Note: If you wish to take advantage of the problems fixed in the code generators, you need to rebuild and re-link your models.

Connexis

Note: If you wish to take advantage of the problems fixed in the DCS, you need to rebuild and re-link your models.

Licensing

For additional information on licensing, see You Must Install License Keys to Run this Product.

Installation Issues

After Installing IBM Rational Product, Restart System Before Applying This Service Release

After you install a Rational product, you must restart your system before applying this service release. Do not apply this service release until you have restarted your system after installing a Rational product. See RATLC516372, below.

RATLC00516372 - If the Rational Setup Wizard does not appear when you apply this service release, use Windows Task Manager to end one of the msiexec.exe processes. The Rational Setup Wizard window should appear. If it still does not appear, cancel the next msiexec.exe. As a result, installation of this service release should be successful. Workaround: Restart you system before applying this Service Release.

Microsoft Windows 2000 NTFS "Change Journal" defect can cause file system corruption during installation of Rational products

Under certain circumstances, file system corruption can result from installing Rational Version 2003 products on Windows 2000 to an NTFS partition that has enabled the Windows "Change Journal" (log). This corruption is caused by a defect in Windows 2000. Before you install any Rational Version 2003 product on Computer that is running Windows 2000:

  1. Disable all virus detection software
  2. Read IBM Support Technote 1135295. Go to http://www-1.ibm.com/support/us/search/index.html and search for "Rational Installer Change Journal."
  3. Read Microsoft Knowledge Base article 820888 at http://support.microsoft.com/default.aspx?scid=kb;[LN];820888. This article includes information about an update from Microsoft that fixes the defect.

Upgrading from Rose RealTime 2003.06.00

If you are installing Rose RealTime v2003.06.01 or greater as an upgrade to an existing installation of Rose RealTime 2003.06.00, the Rose RealTime TargetRTS files may not update (install) correctly.  In order to avoid unpredictable results, uninstall Rose RealTime v2003.06.00 before installing Rose RealTime v2003.06.01 or greater.  This is a known issue:  RATLC00517283.

Installation Notice Regarding Upgrade Installation of AnalystStudio

Some features included in AnalystStudio have duplicate component IDs causing issues with upgrades to this product. As a result, if you are upgrading IBM Rational Suite AnalystStudio v2003.06.01or v2003.06.12 to this service release, you must first uninstall AnalystStudio before installing v2003.06.13 of this product.

Attempting to install this release as an upgrade to IBM Rational Suite AnalystStudio v2003.06.01or v2003.06.12 will cause unpredictable runtime results as release files may not be updated correctly.

Installing Rational Rose RealTime after Installing Rational Suite DevelopmentStudio

If you install Rational Suite DevelopmentStudio, and then install the Rational Rose RealTime point product, select Add-Ins > Add-In Manager and select the appropriate add-ins, such as SoDA, RequisitePro, and Trace Tool. Selecting these tools activates the integration of Rational Rose RealTime with those tools. 

Receiving a Warning when Missing the File Objects.dll

When installing Rational Rose RealTime on Microsoft Windows, or starting Rational Rose RealTime for the first time after installing, you may receive an error message indicating the following:

 "suite objects.dll" cannot be found in the path."

This problem only occurs on Microsoft Windows NT systems that have had a previous version of Rational Rose RealTime installed. To solve this problem, add "C:\Program Files\Rational\common" to your Path variable.

Compatibility Issues

For additional information on compatibility issues, see the Product Support section of the Rational Rose RealTime web site at:

http://www.ibm.com/software/rational/support/

Late Changes to Documentation

For the most recent documentation updates, visit the Product Support section of the Rational Rose RealTime web site at:

http://www.ibm.com/software/rational/support/

Where printed documentation exists, always refer to the online Help or PDF versions of the book for the latest updates. 

Known Issues

For a list of known issues in this release, see the Rose RealTime Release Notes, located in .<ROSERT_HOME>/rosert_readme.html.

Product Documentation

Documentation for IBM Rational is available on-line at http://www.ibm.com/software/rational/support/documentation/.

Additional information about this release is available in the Addendum, Rational Rose RealTime, located in <ROSERT_HOME>/Help/rosert_addendum_2003.pdf.

Defects Fixed in This Release

RATLC / APAR ID

Description

RATLC00246421, 519781 / IC39701 Rose RealTime may hang upon selecting File > Control Unit.  When the model is controlled, each Model element (example UseCase etc) are stored in a separate file. Rose RealTime verifies that each file name is unique and generates unique file names for each element.  The file name is generated based on the element name given by the user.  The general form of the file name is <user given element name>. Extension.  An error occurs when attempting to generate a unique file name if the element name contains a "."
RATLC00246676 / IC39633 RoseRT may crash and produce the following error, when loading a model with a hyperlink:

NT Exception 001B:005C2C20
RATLC00247365 Enhancement to add Sequence Diagram name to RQART messages.  

RQART now displays the name of the test along with the test number that had passed / failed in the test summary pages.

RATLC376345 / IC39736 Expansion levels in the Query toolbar option, do not work properly.  For example, the value levels in Selected Elements cannot be reset to 1 once they are set to level higher than 1. 
RATLC00516355 Toolset crash can occur after configuring capsule for both Connexis CRM and CDM, twice.  For example, occurs when trying to configure the same capsule for Connexis after re-opening the model.
RATLC00516591 / IC37635 Code generation HeaderPreface can be incorrect if the last character in the HeaderPreface is not a newline character.
RATLC00517053, 519068 / IC38052 Rose RealTime Toolset times out when using the RoseRT / ClearCase / ClearQuest integration and "Window trigger selection" - "V2"
RATLC517297 / IC37917 Slow display of role list for interaction instance on a Sequence Diagram.  (See "Enhancement for Slow Performance when Displaying Sequence Diagram Role List", the Rose RealTime Release Notes). 
RATLC00518307 / IC38924 Generation of dependencies is incorrect for makefiles in relation to Java components.
RATLC00518507 / IC37876 After modifying a controlled collaboration diagram which includes children ,under source control, then performing an undo checkout of the collaboration diagram may cause references to the children to be lost.
RATLC00518786 / IC39194 Model corruption occurs, on Japanese OS, when including actors in collaboration diagrams.
RATLC00518787 / IC39069 Connexis CDR / ASCII Encoding does not function correctly when working with data for which the size is greater than 64K.
RATLC00518788 / IC39070 Connexis Viewer metrics collection does not function correctly if the component instance is using ASCII encoding / decoding (-CNXtde-1).
RATLC00518847 / IC37316 Slow model validation for large enumeration (i.e. several attributes included).
RATLC00518960 / IC39135 Nested classes result in an incorrect collaboration classifier role.  (If a nested class is used as a collaboration classifier role, the classifier identified on the classifier role specification points to an incorrect class.)
RATLC00518986 / IC37640 Rose RealTime Toolset may crash when copying and pasting Choice-point.
RATLC00519013 IC39198 The Check Unique identifiers presence function does not scale to large models.
RATLC00519023 / IC37640 RoseRT may crash and display the following error when deleting send signal that has text attached and then saving the model:

NT Exception 001B:0000..
RATLC00519049 Class shape becomes smaller on a diagram, upon adding an aggregation.
RATLC00519193 Transition Labels may incorrectly relocate upon editing state diagrams.
RATLC00519208 / IC37851 Unresolved references from Interactions to roles may occur, where for example a role is specified by a capsule which is included in nested capsule roles due to decomposition.
RATLC00519209 / IC37360 Sending enum in Connexis does not function correctly in Rose RealTime 2003.  When data is sent from the sender, Connexis tries to decode the data.  If the decode fails, it is ignored.  This is due to the fact that the CodeGen does not generate data type installer code for the enum datatype, which helps decoding data.
RATLC00519358 Disabling the Add-In, "External Library Generation".  See http://www-1.ibm.com/support/docview.wss?uid=swg21117982 for further information.
RATLC00519456 / IC39013 The Connexis Viewer truncaates long messages (longer than 4096 bytes) even when the component uses the following command line options:

CNXatud=-1 -CNXtmts=CRM:65500 -CNXtbp=64:1,600,32:65500:16
RATLC00519465 Faulty renaming of state in superclass, causes RoseRT to crash upon loading model.
RATLC00519781 / IC39701 RoseRT may hang upon selecting File > Control Unit if an included element name includes the "." character.
RATLC00520349 / IC39882 Unable to decode nested enum implemented according to the enumerated stereotype.  For a nested class, both the outer and inner class is installed.  However, this is not the case for the enumeration.  The code generator should install RT Type_Enuminner as well.
RATLC00520380, 520437, 520663 / IC39934 Error executing "rterror.pl", due to use of uninitialized variables:

Use of un-initialized value at rterror.pl line xxx
RATLC00520393 / IC39947 Unresolved pathmap occurs when relative pathmaps are used for external documents.  (Sequence Diagram).
RATLC00520402 Rose RealTime C++ code generator will not build components where two components refer to the same class.  When the component being built references two different components that have the same referenced items, the following error may occur:

Error: The name of this class (from component 'Component View::Three') is not unique in component 'Component View::One' NMAKE : fatal error U1077: 'rtcppgen' : return code '0x3' Stop.

New command line option available, "-fignore-dup-names" which can be set to ignore the duplicate name conflicts when a component is referring to two other components, and both of which are referring to the same class.  This would be allowed even if  name conflicts exist.

RATLC00520425 / IC39999 Enhancement to remove the "-nostdinc" flag from the TargetRTS for Tornado 2.2.
RATLC00520598 / IC40273 Model Integrator may create corrupt model when merging file with Rose RealTime 2003,  as pipe characters are incorrectly removed.
RATLC00521496 / IC40535 Model line colors are not saved correctly.
RATLC00521728 / IC40581 External document links don't work correctly when using pathmaps.
RATLC00521821 / IC40591 Font color for Default Font is not saved correctly, if font color is set to black.
RATLC00522059 / IC40688 TargetRTS may be missing in Tools Menu for Rose RealTime 2003.06.12.  Corrected by adding the necessary registry entry.
RATLC00522223 Enhancement in Rose RealTime Java to improve method visibility in Sequence Diagram.  See "Rose RTJava Improvement to Method Visibility in Sequence Diagrams" in the Rose RealTime Release Notes.

RATLC000522638 / IC41029

Upon attempting to load the latest version of a Rose model could result in the following error:

Error:  Error reading file C:\rose_sample.mdl at line XXX

Fix included to maintain compatibility with newer Rose petal file format.
RATLC00522942 Connexis CRM application enters tight loop when Connection is broke at the server end.  This consumes 100% of CPU cycles before the rtUnbound is received.  The problem does not occur with CDM.

RATLC00524473 / IC41405

Memory Leak in Connexis DCS.rtmdl
The transportName was deleted incorrectly in the Logical View -> DCSComponents-> DCSController-> RTDRemotePort->cleanup function.  "delete transportName; changed to delete [] transportName;

Files changed by this release


[Release_Location]\bin\win32\RoseRT.exe
[Release_Location]\
bin\win32\RrtRes.dll
[Release_Location]\bin\win32\rtcgen.exe
[Release_Location]\bin\win32\rtcppgen.exe
[Release_Location]\bin\win32\rtjavagen.exe
[Release_Location]\
bin\win32\rtrun.exe
[Release_Location]\bin\win32\modelintRTres.dll
[Release_Location]\bin\win32\modelintRT.exe
[Release_Location]\bin\win32\rtcbld.dll
[Release_Location]\
bin\win32\rtcppbld.dll
[Release_Location]\bin\win32\rtjavaui.dll
[Release_Location]\RQART\bin\win32\rqart.dll
[Release_Location]\RQART\bin\win32\rqartRes.dll
[Release_Location]\
Connexis\bin\win32\Connexis.dll
[Release_Location]\Connexis\bin\win32\ConnexisRES.dll
[Release_Location]\Connexis\bin\win32\ConnexisViewer.exe
[Release_Location]\Connexis\bin\win32\ConnexisViewereRES.dll
[Release_Location]\Connexis\bin\win32\TraceData.dll
[Release_Location]\Connexis\C++\lib\NT40T.x86-VisualC++-6.0\DCS.LIB
[Release_Location]\Connexis\C++\lib\TORNADO2T.simpc-egcs-2.90.29\libDCS.a
[Release_Location]\C++\TargetRTS\config\TORNADO22T.ppc603-gnu-2.96\config.mk
[Release_Location]\C++\TargetRTS\config\TORNADO22T.simnt-gnu-2.96\config.mk
[Release_Location]\C++\TargetRTS\config\TORNADO22T.simnt-gnu-2.96\setup.pl
[Release_Location]\C++\TargetRTS\config\TORNADO22T.ppc603-gnu-2.96\config.mk
[Release_Location]\C++\TargetRTS\config\TORNADO22T.simnt-gnu-2.96\config.mk
[Release_Location]\C++\TargetRTS\config\TORNADO22T.simnt-gnu-2.96\setup.pl
[Release_Location]\C\TargetRTS\config\TORNADO22T.ppc603-gnu-2.96\config.mk
[Release_Location]\C\TargetRTS\config\TORNADO22T.simnt-gnu-2.96\config.mk
[Release_Location]\C\TargetRTS\config\TORNADO22T.simnt-gnu-2.96\setup.pl
[Release_Location]\rosert\RoseRTRTS.msm
[Release_Location]\C++\TargetRTS\src\RTAsciiDecoding\get_indirect.cc
[Release_Location]\C++\TargetRTS\codegen\rterror.pl
[Release_Location]\C\TargetRTS\codegen\rterror.pl
[Release_Location]\rosert_readme.html
[Release_Location]\rosert_readme_sr.html

Note: 
[Release_Location] is the directory that the IBM Rational Products are installed in.  This is typically "C:\Program Files\Rational\Rose RealTime*".

 

Contacting IBM Rational Software Support

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

Voice Support is available to all current contract holders via a telephone number in your country (where available). For specific country phone numbers, please refer to the IBM Software Support Handbook, Appendix B: Contact Information, found at http://www.ibm.com/software/support.