Readme for Rational Rhapsody 8.1.5 iFix004

Note that the installation of this iFix requires you to manually extract the content of a number of .zip files after you run the executable file provided. See the installation instructions at the end of this document for details.

Changes in iFix004

Changes in iFix003

Changes in iFix002

Changes in iFix001

Installation instructions

Improvements for Rhapsody Design Manager users

This iFix is required to complement Rhapsody DM 6.0.2 iFix011 (available on jazz.net).

Rhapsody APARs Fixed with 8.1.5 iFix004

Category APAR ID Summary
Activity Diagram PI70590 Viewing activity diagrams - lines disappear
Activity Diagram PI74289 ARGUMENT ERRORS WHILE CREATING SEND ACTION ON ACTIVITY DIAGRAM
Activity Diagram PI81254 Unable to reference call behavior after upgrade.
AUTOSAR PI75465 EvaluationException : java.lang.ArrayStoreException when exporting to ARXML
Browser PI71148 ERROR MESSAGE AFTER CLOSING RHAPSODY
Code Generation PI78677 CRASH WHEN BUILDING CODE WITH TESTCONDUCTOR TESTCASE
Code Generation PI80353 Flowport code generation error - not sensitive to namespace
Code Generation PI81510 include not generated depending on number of packages
Eclipse Rhapsody Plug-in PI81041 CRASH WHEN SAVING IN RHAPSODY AND ECLIPSE IS OPEN
Graphic Editors PI74653 Creating Accept Event Action doesn't display inherited arguments
MicroC CG PI80554 Rhapsody 8.2: Building code with MicroC: Unable to make 'mxf_cfg.h' when 8.1.5 is uninstalled
Modeling - General PI78915 Inner actor that inherits from outer actor causes crash when user opens features window of panel diagram element
Modeling - General PI79490 Loss of terms/stereotypes after unloading reference package containing stereotype definitions
MXF PI74036 QAC VIOLATIONS WITH RHAPSODY FRAME WORK & ADOPTION CODE.
Report on Model PI72716 RHAPSODY CRASHED WHEN EXECUTING 'EXPORT DIAGRAM IMAGE' ON A STATECHART
TestConductor PI77191 Unexpected occurrence of message during TestConductor sd test execution.

iFix004 for Rhapsody 8.1.5 includes the following fixes, which were included in iFix003.

Rhapsody APARs Fixed with 8.1.5 iFix003

Category APAR ID Summary
AUTOSAR PI62909 Wrong order of SwComponentPrototypes in VariableDataPrototypeInSystemInstanceRef
Browser PI73965 ARXML file moved during ARXML Import
Code Generation PI73079 Namespace CG conflict causes truncated path in operation return type
DiffMerge PI75102 Diffmerge crashes while trying to save merge
Features Dialog PI57286 CRASH - RHAPSODY WILL CRASH IF YOU SELECT THE FULLPORT OPTION ON THE PROXY PORT TAB
Features Dialog PI70000 Tagged value getting changed
Graphic Editor - General PI59614 Unable to rename a flowport on a part
Graphic Editor - General PI65611 Size of Internal Block Diagram (IBD) increases every time you add a connector between a proxy port and a nested proxy port
Graphic Editor - General PI65865 Unable to connect a Subproxyport of a Nestedproxyport to another proxyport.
Graphic Editor - General PI67686 'ObjectModelGe::proxyPort::ShowName' property for Flow/Proxy ports does not work correctly for 'Label'.
Graphic Editor - General PI75301 Multiple Flow Arrows added after "Layout-->Complete Relation->All"
Modeling - General PI60550 DIRECTION OF NESTED PROXYPORT NOT UPDATED WHEN CONJUGATE OF INNER PROXYPORTS IS DONE
Modeling - General PI64283 CRASH WHEN CREATING A NEW INTERFACEBLOCK FOR A PROXYPORT AND GIVING IT THE SAME NAME AS THE PARENT
Modeling - General PI64987 PI64987: 16 ERROR POPUPS WHEN CLICKING ON HYPERLINK
Modeling - General PI68567 Updating missing units ignores ReferenceUnitPath=Relative and sets absolute path
Repository PI64896 Increasing memory while loading/unloading package
Table Matrix PI75443 modifying table layout removes Java code
User Interface PI72561 RHAPSODY BEGIN TO HANG WHILE MOVING/CLICKING THE MOUSE ON CODE->DEBUG/TARGET MENU

Improvements included in iFix003 for Rhapsody users

Diagrams: improved routing of connectors

A number of improvements have been made to the way that connectors are routed when first drawn, and to the way that connectors are re-routed when connected objects are moved in a diagram. This feature can be enabled by clicking the relevant button in the Layout toolbar or by modifying the value of the property General::Graphics::SmartRouting.

Diagrams: connection points for rectilinear lines

For rectilinear connectors in diagrams, it is now possible to specify that the connection points to elements should stay fixed when the elements are moved. This behavior is controlled by the new property General::Graphics::KeepEndPoints.

New property added to facilitate straightening of connectors in diagrams

A new property, General::Graphics::SnapEdgeAlignmentDistance, was added to make it easier to straighten connectors that have bends in them. When the distance required to straighten such a connector is smaller than the value set for this property, you only have to move the connector slightly in the appropriate direction, and the connector will "snap" to the point required to make it straight.

Limiting the number of ports displayed on single element

In order to limit the impact on performance, a new property, MaximumNumberOfPortsToDisplay, has been added to make it possible to limit the number of ports that are displayed for a single element in a diagram. If you have created more ports on the element than the number specified with this property, you will see a message indicating that not all of the ports are shown.

Display of additional information when hovering over item in list of open tabs

When you hover over an item in the menu that lists the open tabs, a tooltip with additional information is now displayed.

Conditional property syntax - additional options added

When using the conditional property syntax, you can now include the following options.

Rhapsody API - errorMessage() and getErrorMessage() - change in behavior

Previously, the errorMessage() and getErrorMessage() methods would return the most recent error. So if a method call resulted in an exception, and you called additional methods afterwards, you could still get the original error, provided that the additional calls were all successful.

Now, the most recent error is cleared when a method is called successfully. So in order to get the error message, getErrorMessage() must be called immediately after the method that failed. This applies to:

Use of relative paths in repository files

A new variable called UseRelativePathForRefsToNonLocalUnits can now be used in the General section of the rhapsody.ini file. This variable can be used to control whether relative paths are used for the filepaths of model references in repository files. If the variable is set to TRUE, the path to the saved unit of a referenced element appears as a path relative to the saved unit of the referencing element.

Note that if you are using (1) an earlier version of Rhapsody that does not support this variable or (2) a Rhapsody instance where the variable is not set to TRUE, then attempts to add a unit to model, with dependents, may not succeed in adding the dependents of the unit if that unit was saved with this variable set to TRUE.

Rhapsody API - methods that cannot accept NULL as parameter

Prior to this release, when a NULL value was passed to an API method that expects a non-NULL parameter, the message "Element Deleted" was displayed. Beginning with this release, the error message that is displayed in such cases is "Invalid parameter".


iFix004 for Rhapsody 8.1.5 includes the following fixes, which were included in iFix002.

Rhapsody APARs Fixed with 8.1.5 iFix002

Category APAR ID Summary
AUTOSAR PI63099 Contexttags are deleted when model element ApplicationSwComponentTypes is moved from one ARPackage to another.
AUTOSAR PI64690 CLIENT-SERVER-OPERATIONs order is not retained after arxml export
AUTOSAR PI64895 Re-Import of ARXML causes element duplication
Code Generation PI65322 REGRESSION: VariationPoint stereotype assigned to object no longer compiles
Graphic Editors PI61105 Strange behavior of ports in diagrams
Java API (COM) PI48751 Constraint name not correctly set in Rhapsody Sequence Diagram.
Modeling - General PI55736 RHAPSODY CAN NOT FIND AND FIX UNRESOLVED ELEMENTS IN DESCRIPTIONS
Sequence Diagram PI63038 renaming message in sequence diagram changes operation in browser
Statechart PI65578 Substatemachine arrows get rerouted
TestConductor PI64042 Extreme performance problems when executing test architectures

Improvements included in iFix002 for Rhapsody users

Enhanced document generation using RPE to show Table content in HTML format


iFix004 for Rhapsody 8.1.5 includes the following fixes, which were included in iFix001.

Rhapsody APARs Fixed with 8.1.5 iFix001

Category APAR ID Summary
AUTOSAR PI61447 NVBLOCKDESCRIPTOR IS ONLY AVAILABLE IN RHAPSODY ARCHITECT FOR SYSTEM ENG USING AR403
AUTOSAR PI61501&PI60889 NVBLOCKDESCRIPTOR IS NOT EXTRACTED VIA ARXML IMPORT
Java API (COM) PI60081 Local tag is duplicated endlessly after using API

Improvements included in iFix001 for Rhapsody users

Improved stabilization of the 64-bit version of Rhapsody

Additional implementation of the Rhapsody Obfuscator sample that can also be used with pre-815 models

Packed as a zip file:

New command line to load user plugins using a .hep file

Command line is "-cmd=load_hep "

IRPHApplication.RefreshAllViews() is enhanced to refresh the tool to reflect the selected perspective

"Export to file..." in Table/Matrix view supports export content as CSV file

New callbacks on: IRPApplicationListener


Applying the iFix

A number of steps in this section refer to the Share directory as being a subdirectory of the main Rhapsody installation directory. Note that if you performed a "split" installation of Rhapsody - meaning that you did not use the "Install all Rhapsody files in one location" option - then the Share directory will be located in the user home directory, for example, C:\Users\\IBM\Rational\Rhapsody.

On Windows - for 32-bit version of Rhapsody

  1. Verify that you have installed IBM Rational Rhapsody 8.1.5 (BuildNumber-9728113).
  2. Make sure that Rhapsody is not currently running.
  3. Download the .zip file for the iFix: Rhapsody815iFix004_x86.zip
  4. Move the contents of the <Rhapsody installation directory>\Eclipse folder to a backup folder.
  5. After extracting the contents of the .zip file, run the executable file Rhapsody815iFix_x86.exe
  6. Click Update in the InstallShield Wizard.
  7. Click Finish when the installation is done.
  8. In the folder <Rhapsody installation directory>, locate the file RhapsodyRoot.zip.
  9. Use "extract here" to extract the contents of RhapsodyRoot.zip
  10. Move the contents of the <Rhapsody share directory>\LangC\mxf folder to a backup folder.
  11. Open the folder <Rhapsody installation directory> and locate the file RhapsodyShare.zip. (If you performed a "split" installation, the RhapsodyShare.zip file will be located in the folder that contains the Share folder.)
  12. Use "extract here" to extract the contents of RhapsodyShare.zip

On Windows - for 64-bit version of Rhapsody

  1. Verify that you have installed IBM Rational Rhapsody 8.1.5 (BuildNumber-9728113).
  2. Make sure that Rhapsody is not currently running.
  3. Download the .zip file for the iFix: Rhapsody815iFix004_x64.zip
  4. Move the contents of the <Rhapsody installation directory>\Eclipse folder to a backup folder.
  5. After extracting the contents of the .zip file, run the executable file Rhapsody815iFix_x64.exe
  6. Click Update in the InstallShield Wizard.
  7. Click Finish when the installation is done.
  8. In the folder <Rhapsody installation directory>, locate the file RhapsodyRoot.zip.
  9. Use "extract here" to extract the contents of RhapsodyRoot.zip
  10. Move the contents of the <Rhapsody share directory>\LangC\mxf folder to a backup folder.
  11. Open the folder <Rhapsody installation directory> and locate the file RhapsodyShare.zip. (If you performed a "split" installation, the RhapsodyShare.zip file will be located in the folder that contains the Share folder.)
  12. Use "extract here" to extract the contents of RhapsodyShare.zip

On Linux

  1. Verify that you have installed IBM Rational Rhapsody 8.1.5 (BuildNumber-9728113).
  2. Make sure that Rhapsody is not currently running.
  3. Download the .zip file for the iFix:Rhapsody815iFix004-Linux.zip
  4. After extracting the contents of the .zip file, open IBM Installation Manager.
  5. From the menu, select File --> Preferences.
  6. Select "Add Repository".
  7. Click "Browse..." and select the file <Rhapsody8.15_iFix4 extract folder>\repository.config
  8. Clear the "search service repositories during installation and updates" check box.
  9. Click "OK" to close the Preferences dialog.
  10. Click "Update".
  11. Select "IBM Rational Rhapsody Developer 8.1.5" installation and click "Next".
  12. Select "IBM Rational Rhapsody Developer 8.1.5 iFix 004" and click "Next".
  13. Click "Update" to start the update process.
  14. Click Finish when the installation is done.

Uninstalling the iFix

On Windows

  1. Go to Control Panel > All Control Panel Items > Programs and Features, and select "View installed updates".
  2. Select the relevant entry under IBM Rational Rhapsody 8.1.5xxxx
  3. Open the folder: <Rhapsody share directory>\LangC\mxf
  4. Restore the content of this folder from the backup created during the installation.
  5. Open the folder: <Rhapsody installation directory>\Eclipse
  6. Restore the content of this folder from the backup created during the installation.

On Linux

  1. Open IBM Installation Manager.
  2. Click "Uninstall".
  3. Select "IBM Rational Rhapsody Developer 8.1.5 (iFix 004)" and click "Next".
  4. Click Finish when done.