Troubleshooting
Problem
There can be various build errors in Rational Rose® RealTime on Microsoft® Windows® platforms when using Microsoft Visual Studio®.
Symptom
A problem mainly manifests itself right after you have installed Rose RealTime and want to build and execute your first model.
The symptoms generally look like
- NMAKE : warning U4010: 'CommHeadsUp.OBJ' : build failed; /K specified, continuing ...
- Command not found
- unable to create process for 'nmake'
- 'rtcgen' is not recognized as an internal or external command
- 'rtcppgen' is not recognized as an internal or external command
- error LNK2001: unresolved external symbol _RTMessage_getData
Cause
The symptoms vary depending on your environment, but the root cause is always the same.
Rational Rose RealTime needs to be able to call the code generation tools and compiler tools (cl, nmake and link) from the command line. If these tools cannot be called from the Microsoft Windows NT® command line, a build error will follow.
The easiest way to see if your environment is correct is to issue the following commands from a Windows NT command line:
rtcppgen -version
cl
nmake
link
If these commands execute without any problem and you still are not able to build, you are encouraged to contact IBM® Rational Customer Support for Rose RealTime.
Resolving The Problem
The modifications below are the minimal set of environment modifications needed to use Microsoft® Visual C++® with Rose RealTime. They do not enable the user to use the complete Microsoft Visual Studio development tools from the command line.
The Path environment variable should include a path to the Rational Rose RealTime executables. For Windows, this is the location where the application was installed, followed by bin\win32. This path could be represented by %ROSERT_HOME%\bin\%ROSERT_HOST%.
ROSERT_HOME and ROSERT_HOST are environment variables which must be set at the SYSTEM environment variables level with the Path environment variable. It is always safest to modify the path statement with a complete path to the Rose RealTime executables. Verify that the executables can be found with a new command line test.
Open the Component Specification and click the C++ compilation tab. Verify that the Compilation Make Command field is specified as rtperl -S rtsetup.pl $defaultMakeCommand. If it is not, replace this in the default set of properties, revert any components to default, and try to build the application again.
Failing this, during installation of Microsoft Visual Studio 6.0, you are presented with a dialogue asking if the compiler tools should be set up for use from the command line. This checkbox should be selected for optimal use with Rose RealTime. If you did not select this option, then there are two options:
- Reinstall Microsoft Visual Studio 6.0.
- Manually modify the NT environment by following the instructions below.
Note: These steps assume Microsoft Visual Studio 6.0 is installed in
C:\Program Files\Microsoft Visual Studio.
If this is not the case in your situation, adjust accordingly. - Modify PATH
Add C:\Program Files\Microsoft Visual Studio\VC98\bin;C:\Program Files\Microsoft Visual Studio\Common\MSDev98\bin - Modify (or set, if missing) INCLUDE
Add C:\Program Files\Microsoft Visual Studio\VC98\ATL\Include;C:\Program Files\Microsoft Visual Studio\VC98\Include;C:\Program Files\Microsoft Visual Studio\VC98\MFC\Include - Modify (or set if missing) LIB
Add C:\Program Files\Microsoft Visual Studio\VC98\Lib;C:\Program Files\Microsoft Visual Studio\VC98\MFC\Lib - Shut down the computer, restart, and restart Rose RealTime
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21123593