IBM Support

Configuring Rational Rhapsody 8.x to use Microsoft Visual Studio 2017 compiler

Question & Answer


Question

How do you configure IBM Rational Rhapsody 8.x to use Microsoft Visual Studio 2017 compiler?

Cause

You wish to compile Rational Rhapsody projects with the Microsoft Visual Studio 2017 compiler.
UPDATE:
Please note these instructions are for Pre-8.3.1 Rhapsody only!
Rhapsody 8.3.1 and higher now officially supports the Microsoft Visual Studio 2017 compiler. If you are using Rhapsody 8.3.1 and higher you can follow these steps:
1. Select the Microsoft Visual Studio 2017 compiler during Rhapsody installation
2. Create a new project
3. Open the features window for the active configuration
4. Set the environment to MSVC
5. Set the CPP_CG::MSVC::IDEVersion property to VC15.

Answer

Download and Setup
  1. Close Rhapsody.
  2. Download and extract the zip archive file (see below) to any convenient location on your file system.
  3. Copy the share.zip to the location that contains the share directory of your Rhapsody installation. This could be in one of the following locations depending on the option chosen during installation:

    - C:\Program Files\IBM\Rational\Rhapsody\<Version>
    - C:\Program Files(x86)\IBM\Rational\Rhapsody\<Version>
    - C:\ProgramData\IBM\Rational\Rhapsody\<Version>
    - C:\Users\<UserName>\IBM\Rational\Rhapsody\<Version>

    Or a custom installation location if chosen.
    This location will be referred to as <RHPINSTALL> from now on.
  4. (optional) If you have customized the Rhapsody installation make a backup of the share directory now.
  5. Unzip the share.zip at this location. You will be prompted to confirm if you want to overwrite various directories and files. Select "Yes to all".
  6. Create an environment variable VS_2017_PATH and add the root directory of your Visual Studio 2017 installation. For example, the default is:

    C:\Program Files (x86)\Microsoft Visual Studio
     
  7. Start Rhapsody for Cpp or Rhapsody for C and load the respective Dishwasher sample project Cpp or C. These can be found at the <RHPINSTALL>\Samples\CppSamples\Dishwasher and <RHPINSTALL>\Samples\CSamples\Dishwasher directory respectively.
  8. Select the Build Framework item from the Code menu to rebuild the Rhapsody OXF framework for Visual Studio 2017.
    This will take several minutes.
  9. Select the Generate/Make/Run item from the Code menu to build the Dishwasher sample project Visual Studio 2017.

Note1: To switch back to previous versions of Visual Studio, change the CPP_CG::MSVC::IdeVersion property.
Note2: To use the 64bit version of the compiler switch the CPP_CG::MSVC::CPU property to "amd64". Repeat step 8.


List of changes made to share directory:

More detail can be found below regarding the specific changes to the share directory contents.
 
  1. share\etc\makemsvc.bat

  2. share\LangCpp\msbuild.mak

  3. share\LangCpp\osconfig\WIN32\omosconfig.h

  4. share\Properties\siteC++.prp

  5. share\Properties\siteC.prp

  • 'Importing HTML'.

[{"Product":{"code":"SSB2MU","label":"IBM Engineering Systems Design Rhapsody"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"General Information","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"8.0;8.0.1;8.0.2;8.0.3;8.0.4;8.0.5;8.0.6;8.1;8.1.1;8.1.2;8.1.2.1;8.1.3;8.1.4;8.1.5;8.2","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Product Synonym

Rational Rhapsody

Document Information

Modified date:
27 May 2022

UID

swg22000981