Readme for Rational Rhapsody 8.2 iFix001

Improvements for Rhapsody Design Manager users

This iFix is required to complement Rhapsody DM 6.0.3 iFix001 (available on jazz.net).

Rhapsody APARs Fixed with 8.2 iFix001

Improvements included in iFix001 for Rhapsody users

New command-line option added

-cmd=close_all_diagrams

This new command closes all diagrams that are currently open.

Shortcut list for graphic elements - improvements

All elements that can contain compartments now have a property called QuickNavigationCategory, which is used to compose the shortcut list. The property can include any of the following categories:

• MainBehavior
• MainDiagram
• Hyperlinks
• InternalBlockDiagrams (for SysML only)
• Diagrams
• StateCharts
• Activities
• References
• DiagramReferences

In addition, the shortcut list is now available on boxes in Structure mode as well (not just Specification mode).

The shortcut list can be enabled/disabled by modifying the value of the property General::Graphics::EnableQuickNavigation. After changing the value of the property, you have to refresh the diagram (F5) or reopen the model for the change to take effect.

Code generation - new property - FullQualifiedTypeName

The following properties were added to the C++ factory. If the value is changed to True, it forces generation of full qualified name. Note that to activate the fix for PI73079 (Namespace CG conflict causes truncated path in operation return type), you must add these properties to the site.prp file with a value of True.

Subject CPP_CG
	Metaclass Operation
	    Property FullQualifiedTypeName Bool "False"
	end 
	Metaclass Argument
	    Property FullQualifiedTypeName Bool "False"
	end
	Metaclass Attribute
	    Property FullQualifiedTypeName Bool "False"
	end
	Metaclass Relation
	    Property FullQualifiedTypeName Bool "False"
	end
end

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()

Support for ReporterPlus in 64-bit version of Rational Rhapsody

In addition to the iFix files, a separate executable file has been provided for adding support for ReporterPlus to the 64-bit version of Rational Rhapsody. To add support for ReporterPlus:

1. Install the iFix according to the instructions in this document.
2. Extract the files contained in RhapsodyReporter82iFix1_X64.zip
3. Run the executable file that was extracted.

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

Constraints, comments, and requirements - changes in appearance

For constraints, comments, and requirements in diagrams, minor changes have been made to the icon that is displayed in the corner of the element - in terms of the location and background color of the icon.

Applying the iFix

On Windows - using MSI installation to install iFix for 32-bit version of Rhapsody

1. Verify that you have installed IBM Rational Rhapsody 8.2 (BuildNumber-9794446).
2. Make sure that Rhapsody is not currently running.
3. Download the .zip file for the iFix: Rhapsody82iFix001_x86.zip
4. After extracting the contents of the .zip file, run the executable file Rhapsody82iFix_x86.exe
5. Click Update in the InstallShield Wizard.
6. Click Finish when the installation is done.
7. Open the folder <Rhapsody installation directory>\RTCIntegration
8. Back up the folder by moving its content to a different folder, leaving only the file RTCDirectIntegrationPlugin.zip
9. Use "extract here" to extract the contents of RTCDirectIntegrationPlugin.zip
10. Open the folder <Rhapsody installation directory>\Eclipse
11. Back up the folder by moving its content to a different folder, leaving only the file EclipsePlatformIntegration.zip
12. Use "extract here" to extract the contents of EclipsePlatformIntegration.zip

On Windows - using MSI installation to install iFix for 64-bit version of Rhapsody

1. Verify that you have installed IBM Rational Rhapsody 8.2 (BuildNumber-9794446).
2. Make sure that Rhapsody is not currently running.
3. Download the .zip file for the iFix: Rhapsody82iFix001_x64.zip
4. After extracting the contents of the .zip file, run the executable file Rhapsody82iFix_x64.exe
5. Click Update in the InstallShield Wizard.
6. Click Finish when the installation is done.
7. Open the folder <Rhapsody installation directory>\RTCIntegration
8. Back up the folder by moving its content to a different folder, leaving only the file RTCDirectIntegrationPlugin.zip
9. Use "extract here" to extract the contents of RTCDirectIntegrationPlugin.zip
10. Open the folder <Rhapsody installation directory>\Eclipse
11. Back up the folder by moving its content to a different folder, leaving only the file EclipsePlatformIntegration.zip
12. Use "extract here" to extract the contents of EclipsePlatformIntegration.zip

On Windows - using archived files to install iFix for 32-bit version of Rhapsody

1. Verify that you have installed IBM Rational Rhapsody 8.2 (BuildNumber-9794446)
2. Make sure that Rhapsody is not currently running.
3. Download the .zip file for the iFix: Rhapsody82iFix001_Win32_archived.zip
4. After extracting the contents of the .zip file, carry out the following steps:
   1. Copy RhapsodyRoot.zip into the <Rhapsody installation directory> folder.
   2. Back up the folder <Rhapsody installation directory> by copying all .exe and .dll files to a different folder.
   3. Use "extract here" to extract the contents of RhapsodyRoot.zip, answering "yes" to override existing files.
   4. Copy RhapsodyShare.zip into the <Rhapsody installation directory>\Share folder.
   5. Back up the following folders by copying their contents to another folder:
      • <Rhapsody installation directory>\Share\Profiles\AUTOSAR
      • <Rhapsody installation directory>\Share\Properties
      • <Rhapsody installation directory>\Share\Settings\UMLPerspectives
      • <Rhapsody installation directory>\Share\JavaAPI
   6. Use "extract here" to extract the contents of RhapsodyShare.zip, answering "yes" to override existing files.
   7. Copy the file <Rhapsody installation directory>\Share\JavaAPI\rhapsody.dll to <Rhapsody installation directory>\Share\JavaAPI\64Bit
   8. Copy the file <Rhapsody installation directory>\Share\JavaAPI\WIN32\rhapsody.dll to <Rhapsody installation directory>\Share\JavaAPI
   9. Remove the folder <Rhapsody installation directory>\Share\JavaAPI\WIN32
   10. Copy RhapsodySamples.zip into the <Rhapsody installation directory>\Samples folder
   11. Backup the folder <Rhapsody installation directory>\Samples\Obfuscator by moving its contents to another folder.
   12. Use "extract here" to extract the contents of RhapsodySamples.zip, answering "yes" to override existing files.

On Windows - using archived files to install iFix for 64-bit version of Rhapsody

1. Verify that you have installed IBM Rational Rhapsody 8.2 (BuildNumber-9794446)
2. Make sure that Rhapsody is not currently running.
3. Download the .zip file for the iFix: Rhapsody82iFix001_x64_archived.zip
4. After extracting the contents of the .zip file, carry out the following steps:
   1. Copy RhapsodyRoot.zip into the <Rhapsody installation directory> folder.
   2. Back up the folder <Rhapsody installation directory> by copying all .exe and .dll files to a different folder.
   3. Use "extract here" to extract the contents of RhapsodyRoot.zip, answering "yes" to override existing files.
   4. Copy RhapsodyShare.zip into the <Rhapsody installation directory>\Share folder.
   5. Back up the following folders by copying their contents to another folder:
      • <Rhapsody installation directory>\Share\Profiles\AUTOSAR
      • <Rhapsody installation directory>\Share\Properties
      • <Rhapsody installation directory>\Share\Settings\UMLPerspectives
      • <Rhapsody installation directory>\Share\JavaAPI
   6. Use "extract here" to extract the contents of RhapsodyShare.zip, answering "yes" to override existing files.
   7. Copy RhapsodySamples.zip into the <Rhapsody installation directory>\Samples folder
   8. Backup the folder <Rhapsody installation directory>\Samples\Obfuscator by moving its contents to another folder.
   9. Use "extract here" to extract the contents of RhapsodySamples.zip, answering "yes" to override existing files.

On Linux

1. Verify that you have installed IBM Rational Rhapsody 8.2 (BuildNumber-9794446)
2. Make sure that Rhapsody is not currently running.
3. Download the .zip file for the iFix: Rhapsody82iFix001-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.2_iFix1 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.2" installation and click "Next".
12. Select "IBM Rational Rhapsody Developer 8.2 iFix 001" and click "Next".
13. Click "Update" to start the update process.
14. Click Finish when the installation is done.

Uninstalling the iFix

On Windows - using MSI installation

1. Open the folder: <Rhapsody installation directory>\RTCIntegration
2. Restore the content of this folder from the backup created during the installation (On Windows - using MSI installation, step #8)
3. Open the folder: <Rhapsody installation directory>\Eclipse
4. Restore the content of this folder from the backup created during the installation (On Windows - using MSI installation, step #11)
5. Go to Control Panel > All Control Panel Items > Programs and Features, and select "View installed updates".
6. Select the relevant entry under IBM Rational Rhapsody 8.2xxxx

On Windows - using archived files

1. Restore the folder <Rhapsody installation directory>:
   1. Restore the folders from the backup created during the installation (On Windows - using archived files, step #4)
   2. Remove the file RhapsodyRoot.zip
2. Restore the folder <Rhapsody installation directory>\Share:
   1. Restore the following folders from the backup created during the installation (On Windows - using archived files, step #4)
      • <Rhapsody installation directory>\Share\Profiles\AUTOSAR
      • <Rhapsody installation directory>\Share\Properties
      • <Rhapsody installation directory>\Share\Settings\UMLPerspectives
      • <Rhapsody installation directory>\Share\JavaAPI
   2. Remove the file RhapsodyShare.zip
3. Restore the folder <Rhapsody installation directory>\Samples:
   1. Restore the folder from the backup created during the installation (On Windows - using archived files, step #4)
   2. Remove the file RhapsodySamples.zip

On Linux

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