Rhapsody RPY Accessor

Overview

The Rhapsody RPY model reader enables to read Rhapsody RPY project files (*.rpy).

Prerequisites

The RPY reader needs to be able to access Rhapsody predefined files (standard Profiles, predefined types, etc.). Those files are located in the Rhapsody Share folder, internally known as the Rhapsody OMRoot.

The Share folder typically contains the following sub folders: JavaAPI\rhapsody.jar, Profiles, Properties etc.

Depending on your operating system and Rhapsody version, the Share folder can typically be found in the Rhapsody install directory or within the user home directory (e.g. "C:\Users\<user>\IBM\Rational\Rhapsody\<version>\Share").

Here is how the RPY reader determines the Rhapsody OMRoot location:

  1. A System property "rhapsody.omroot" may be used to set the location.
    Please refer to this documentation for details on how to set a System property in Eclipse:
    Platform Plug-in Developer Guide > Reference > Other reference information > The Eclipse runtime options.
     
  2. A Windows environment variable "rhapsody.omroot" may be used to set the location.
     
  3. If not found at this stage, the accessor tries to connect to an active Rhapsody application to query its location. Once the location is known, it is stored in an internal preference file for later use, so that there won't be a need to reconnect to Rhapsody in the future.

    Note: You will find the preference file in location %HOMEPATH%\com.sodius.mdw.metamodel.rhapsody.io.rpy\preferences.xml