Readme for Rational Rhapsody 8.1.5 iFix003

Improvements for Rhapsody Design Manager users

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

Rhapsody APARs Fixed with 8.1.5 iFix003

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.

• $<Env::MY_ENV_VAR> - use to include the value of an environment variable
• $<INI::Section,VarName> - use to include the value of a variable from the rhapsody.ini file
• $<ProjectPath> - use to include the path to the .rpy file for the project
• $<ProjectName> - use to include the name of the project

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:

• IRPApplication.errorMessage()
• IRPApplication.getErrorMessage()
• IRPModelElement.errorMessage()
• IRPModelElement.getErrorMessage()

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".

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

Rhapsody APARs Fixed with 8.1.5 iFix002

Improvements included in iFix002 for Rhapsody users

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

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

Rhapsody APARs Fixed with 8.1.5 iFix001

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:

• On Linux: \Samples\Obfuscator\LinuxObfuscator.SuppportPre815.zip
• On Windows: \Samples\WindowsObfuscator.SuppportPre815.zip

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

• afterApplicationClosed();
• beforeProjectOpen(String projectPath);
• afterProjectOpen(IRPProject pProject);
• onPerspectiveChange(String oldPerspective, String newPerspective);

Applying the iFix

Prerequisite

Make sure that you have installed IBM Rational Rhapsody 8.1.5 (BuildNumber-9728113).

On Windows

1. Make sure that Rhapsody is not running.
2. Download the appropriate .zip file for Windows:
   • 32 bit: Rhapsody815iFix3_x86.zip
   • 64 bit: Rhapsody815iFix3_x64.zip
3. Extract the contents of the .zip file into a directory on your computer.
4. Run the installation file that was extracted:
   • 32 bit: Rhapsody815iFix3_x86.exe
   • 64 bit: Rhapsody815iFix3_x64.exe
5. Click Update in the InstallShield Wizard.
6. Click Finish when done.

On Linux

1. Make sure that Rhapsody is not running.
2. Download the file Rhapsody8.1.5_iFix3-Linux.zip
3. Extract the contents of the .zip file into a directory on your computer.
4. Open IBM Installation Manager.
5. Select File > Preferences from the menu.
6. Select Add Repository
7. Click Browse... and select the file repository.config in the directory where you extracted the files.
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 003, and click Next.
13. Click Update to start the update process.
14. Click Finish when done.

Uninstalling the iFix

On Windows

Uninstall for Rhapsody 8.1.5 iFix3 on Windows is not supported. You need to reinstall Rhapsody 8.1.5.

On Linux

1. Open IBM Installation Manager.
2. Click Uninstall
3. Select IBM Rational Rhapsody Developer 8.1.5 iFix 003 installation, and click Next.
4. Click Finish when done.