IBM Rational Rhapsody 8.2.1
IBM Rational Rhapsody 8.2.1 has been made generally available and contains fixes to version 8.2 including all predecessor fix packs.
The Change history section provides an overview on what is new in this release with a description of any new functions or enhancements when applicable.
The How critical is this fix section provides information related to the impact of this release to allow you to assess how your environment may be affected.
The Prerequisites section provides important information to review prior to the installation of this release.
The Download package section provides the direct link to obtain the download package for installation in your environment.
The Installation instructions section provides the installation instructions necessary to apply this release into your environment.
The Known side effects section contains a link to the known problems (open defects) identified at the time of this release.
Click to review the detailed system requirements information for a complete list of hardware requirements, supported operating systems, prerequisites and optional supported software, with component-level details and operating system restrictions.
IBM Knowledge Center provides an entry point to product documentation. You can view, browse, and search online information related to the product.
Click to review a complete list of the defects (APARs) resolved in this release including a list of resolved defects for the entire version family.
Click for information about the migration of existing Rational Rhapsody projects to this version of the product.
Find technical developer content and resources.
Review the Pre-installation tasks section in IBM Knowledge Center.
Before installation, review the Planning the installation section in IBM Knowledge Center.
After installation, review the Post-installation tasks section in IBM Knowledge Center.
Passport Advantage and Passport Advantage Express clients are required to sign in to download the software package.
IBM Software Group OEM offerings are designed for partners who develop and sell business solutions with embedded or bundled IBM middleware software. Clients with Flexible Contract Type (FCT) license purchases and IBM Business Partners must sign in to download the software package.
How critical is this fix?
This is a maintenance release. It contains fixes for client-reported and internally found defects.
There are no known regressions to report.
Known side effects
There are no known issues to report.
Review technote 1461170: Open APARs for Rational products available on the Web for information on how to configure your MyNotifications subscription account and subscribe to the APARs you are interested in following.
AUTOSAR 4.3.0 support
Rational Rhapsody now supports AUTOSAR 4.3.0 modeling.
AUTOSAR: ARXML import and export
A number of changes were made to improve performance when importing or exporting to ARXML.
AUTOSAR: greater differentiation between icons
New icons were added to make it easier to differentiate between element icons and diagram icons in the browser when modeling with the AUTOSAR profile.
AUTOSAR: migration of projects to newer or older versions of AUTOSAR
The range of available versions has been extended for the migration of existing AUTOSAR projects to newer versions of AUTOSAR. Beginning in this release, you can also migrate existing projects to older versions of AUTOSAR.For the exact versions available, see the user interface.
Ada code generation: initialization of discriminant attribute for class instantiated with a relation
Prior to release 8.2.1, a value could be set for a discriminant attribute for classes instantiated with a part. Now, you can also set a value for a discriminant attribute for classes instantiated with a relation.
Ada code generation: support for additional types
Code generation in Ada now supports a number of additional predefined types for UML and SysML models: Real, UnlimitedNatural, and Untyped.
Code generation: InvokePostProcessor property
The keyword $FullCodeGeneratedFileName, which represents the path to the generated file, can now be used in the property CG::File::InvokePostProcessor.
Configuration management: automatic delivery of changes in RTC (Rational Team Concert)
In addition to the option of having modifications made to units in Rhapsody automatically checked-in to RTC (introduced in release 8.2), you can now have modifications to units automatically checked-in and delivered.
Decorations on elements: multiple enhancements
A number of enhancements have been made to the element decoration feature, including: 1) better default location of decoration on element 2) ability to customize the exact location of the decoration 3) performance improvements. In addition, the issues that existed when applying decorations to certain types of elements have been resolved.
Diagrams and Browser: custom views
You can now define Custom View elements for your model to act as filters in determining which elements should be displayed in a given diagram and how the elements should be formatted. Custom Views can be applied individually or in combination in order to customize the appearance of a diagram. Custom Views can also be used to filter the display of model elements in the browser.
Diagrams: creation of Object Model Diagrams in response to Activity Diagram changes
In Activity Diagrams that have swimlanes representing classifiers, if you connect two actions with a control flow or object flow, an Object Model Diagram will be created and it will contain the relevant elements, connected by flows. Note that this feature requires the ModelSynchronization profile.
Diagrams: enhancement of ability to add shortcut list to graphic elements
In release 8.2, the ability to add a shortcut list to graphic elements was introduced for classes, objects, and composite classes. In this release, this ability has been expanded to include other types of graphic elements, including: attribute, comment, constraint, interface, instance specification, operation, package, requirement, stereotype, tag, and type.
Diagrams: Locate in Diagram
When you select Locate in Diagram, the relevant element in the diagram is now highlighted with a flashing color outline for a few seconds. There are a number of properties that can be used to customize the color used for highlighting, and to control how many times the element flashes and the frequency of the flashing. You can find these properties by searching for "LocateInDiagram" on the Properties tab.
Diagrams: Re-Route All - addition of keyboard shortcut
In addition to the Re-Route All menu item, you can now use the Ctrl+Shift+R shortcut to re-route all of the connectors in a diagram.
Diagrams: back and forward navigation buttons
In this release, a change was made to the behavior of the back/forward diagram navigation buttons. Now, when you press the back button, you will be taken to the diagram that you last visited.
Diagrams: hovering Drawing toolbar
In addition to the standard Drawing toolbar, Rational Rhapsody now provides a hovering Drawing toolbar, which is displayed near the current location of the cursor on the drawing canvas. This toolbar is displayed when you click the canvas or a diagram element with the left mouse button. The hovering toolbar is context-sensitive, displaying the icons that are relevant for the current context. For example, if an item such as a class or object is selected on the diagram, the toolbar will display the various connector icons.
Diagrams: new layouts for Populate Diagram and Rearrange
When you select the Populate Diagram or Rearrange options, new layout policies are now available, in addition to the existing Hierarchical and Orthogonal layouts. (Note that the ReArrange submenu is now called Layout.)
Diagrams: 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.
Features dialog: Criteria tab for Queries and Table Layouts
In the Features dialog for Queries and Table Layouts, the Criteria tab (formerly the Element Types & Criteria tab) is now aligned with the Search dialog and provides the same filtering capabilities.
MXF framework: increased MISRA compliance
Changes have been made to the MXF framework in order to increase compliancy with the MISRA standard.
Properties: export of property information to csv file
It is now possible to export the property information for the currently selected element to a csv file. The output is always a reflection of the information displayed on the Properties tab of the Features window. So if you select a filter for viewing the properties, that filter will be reflected in the generated csv file. A number of properties are provided for customizing the csv output.
RTC integration: inclusion of project name in change set comment
When you use the automatic check-in feature, the default change set comment now includes the name of the project. You can customize this comment by modifying the value of the property UnitAutomaticChangeSetComment. For information on other keywords that you can use with conditional properties, see the topic titled "Conditional properties" in the Rhapsody KC (https://www.ibm.com/support/knowledgecenter/SSB2MU_8.2.1/com.ibm.rhp.configuring.doc/topics/rhp_c_cnf_conditional_properties.html)
ReporterPLUS: including tables and matrices as HTML tables
Beginning in this release, for HTML reports generated with ReporterPLUS, you can have tables and matrices from your model included as HTML tables rather than as images (for an example, see the TabularViewsHTML.tpl template).
ReporterPLUS: support for ReporterPLUS in 64-bit version of Rational Rhapsody
ReporterPLUS is now available in the 64-bit version of Rational Rhapsody.
Repository files: detection of changes made outside of Rhapsody
If changes are made outside of Rhapsody to files that represent units, Rhapsody will now notify you of the change and ask if you want to reload the file. (If you want to turn this feature off, add the following variable to the [General] section of your rhapsody.ini file: SandBoxWatcher=false.)
Rhapsody API: additional search criteria for IRPSearchQuery
Additional methods have been added to the IRPSearchQuery interface to allow API-based searches to use all of the search criteria that are available in the Rhapsody GUI.
Rhapsody API: new methods added to RPApplicationListener
Two new methods have been added to the RPApplicationListener class - activeProjectAboutToChange and activeProjectHasChanged. The method activeProjectAboutToChange is triggered when the user selects a different project to serve as the "active" project. The method activeProjectHasChanged is triggered after Rhapsody has changed the "active" project to the one that the user selected.
Rhapsody DM client: partial loading of requirement collections
For collections of remote requirements, you can now choose to load all the requirements, none of the requirements, or only the requirements that have OSLC links to model elements.
Rhapsody Design Manager - Simulink models: hotspot location in diagrams
Improvements have been made in terms of hotspot location for Simulink diagrams in Design Manager.
Rhapsody Design Manager - Simulink models: importing models with nested subsystems
Changes were made to the mechanism for importing Simulink models in order to overcome the following two issues: 1) subsystems with identical names at different levels 2) name of nested path being too long
Rhapsody Design Manager - Simulink models: improved diagram quality
Changes were made to the handling of graphics when importing Simulink models to RDM. In addition to making the import process smoother, these changes result in clearer graphics after import to RDM.
Rhapsody Design Manager - Simulink models: improvements to import process
A number of improvements have been made to reduce the time required for importing Simulink models. In addition, models are now checked for modifications before import. If no changes were made, the model is not imported. A progress bar has also been added, to reflect the progress of the import.
Rhapsody Design Manager - Simulink models: support for MatLab 2016b
RDM now supports Simulink models from MatLab 2016b.
Rhapsody in Ada: warnings during framework compilation
To prevent warnings during the compilation of the RiA frameworks, the -gnatwX option was added to the GNAT configurations for the frameworks.
RulesComposer: loading when Rational Rhapsody API files cannot be found
In cases where the files for the Rational Rhapsody API cannot be found, RulesComposer can now be launched in degraded mode.
RulesComposer: progress bar during loading
A progress bar is now displayed while RulesComposer loads.
RulesComposer: update-site archive for Eclipse Neon (Eclipse 4.6)
RulesComposer workbench has not yet been migrated to Eclipse Neon, however, the update-site archive has been updated to allow the integration of RulesComposer into Eclipse Neon.
Saving Rational Rhapsody models in XML format
As part of the planned move to saving models in XML format, this feature has been introduced in the current iteration as a tech preview. To have Rhapsody save models in XML, add the following variables to the General section of your rhapsody.ini file: WriteXML=TRUE, ShowMissingXMLAttributeMessage=TRUE. Note that at this stage the new XML format cannot be used with: 1) Design Manager 2) Reverse engineering in the 64-bit version of Rhapsody 3) Gateway 4) Models where units have been added without being copied to the project directory
Search and replace: UI enhancements
A number of user interface enhancements have been made to the Search and Refactor features.
Software Architect in 64-bit version of Rhapsody
There is now a 64-bit version of Rational Rhapsody Architect for Software
TestConductor: user-defined mapping of instance lines when creating tests from sequence diagrams
TestConductor now supports user-defined mapping of instance lines (including split/merge) when creating a test case from an existing sequence diagram / test scenario.
TestConductor: navigation to problematic diagram elements when creating test case from sequence diagram
When sequence diagrams are used for creating test cases, you can now navigate directly from problem reports to the problematic message or instance line in the sequence diagram.
TestConductor: sample for use of TC assert macros when testing RAL model
The installation now includes a sample (CppCompositeCoffeeMachine_RAL) that demonstrates the use of assert macros when testing models that use Rhapsody's action language.
TestConductor: support for Rhapsody's action language
TestConductor now supports testing of models that use Rhapsody's action language.
XMI Toolkit: import of SysML 1.4 models
XMI can now import models that use SysML 1.4 into Rhapsody.
IBM Rational Software Support Communities
Helpful Hints For Obtaining Technical Assistance:
Before you contact IBM Rational Software Support, gather the background information that you need to describe the problem. When you describe a problem to an IBM software support specialist, be as specific as possible and include all relevant background information so that the specialist can help you solve the problem efficiently. To save time, know the answers to these questions:
If you have helpful information to diagnose or identify the problem on your system, you can provide this data by following the instructions to exchange information with IBM Technical Support.
Problems (APARS) fixed