Building the IBM Rational Rhapsody WebServices Library

Answer

Below are directions for building the WebServices library.

If you are building the library for one of the Microsoft environments supported by Rational Rhapsody, you should use the makefiles attached to this document instead of those that were included with the 7.5.1 release of Rational Rhapsody. Before running the appropriate batch file, save the relevant makefile to the directory [rhapsody installation directory]\Share\WebServices\ to replace the existing makefile. For the MicrosoftWinCE600 environment, use the file msceWebServices.mak. For the other supported Microsoft environments, use the file msWebServices.mak.

Note: If you are web-enabling a Rhapsody in Java model, you must build an additional library (WebComponentsDLL.dll) in addition to the standard WebServices library. Instructions for building this additional library can be found at the end of this document.

MS CE

1. Edit the batch file mscemake.bat under Share\etc folder.

2. Enter the path to MS CE SDK in the line “set SDKROOT=”

3. Replace “%VS2005_ROOT%” with the path to VS 2005.

4. Open command line and change directory to WebServices folder.

5. Run:..\etc\mscemake.bat msceWebServices.mak build %CPU%

CPU example - ARMV4I

MS VC 6

1. Open command line and change directory to WebServices folder.

2. Run: %VS_98_folder%\VC98\bin\vcvars32.bat x86

3. Run: nmake /f msWebServices.mak CFG=WebServices

MS VC 9

1. Open command line and change directory to WebServices folder.

2. Run:%VS_2008_folder%\VC\bin\vcvars32.bat x86

3. Run: nmake /f msWebServices.mak CFG=WebServices

INTEGRITY

Windows:

1. Open command line and change directory to WebServices folder.

2. Run: IntegrityWebServices.bat %INTEGRITY_Installation_Folder% %CPU% %MULTI_Installation_Folder%

Linux:

The call is replaced by “sh IntegrityWebServices.sh” instead of IntegrityWebServices.bat, all parameters are the same.

CPU example – rpx-cllf

MULTI

Windows:

1. Open command line and change directory to WebServices folder.

2. Run: MultiWin32WebServices.bat %MULTI_Installation_Folder%

Linux:

The call is replaced by “sh MultiLinuxWebServices.sh” instead of MultiWin32WebServices.bat, all parameters are the same.

QNX

QNX Momentics:

1. Create a batch file with the following lines:

set QNXROOT=$QNX_ROOTset MAKEFLAGS=-I%QNXROOT%/target/qnx6/usr/includeset QNX_TARGET=%QNXROOT%/target/qnx6set QNX_HOST=%QNXROOT%/host/win32/x86set QCC_CONF_PATH=%QNX_HOST%/etc/qccset LD_LIBRARY_PATH=%QNXROOT%/target/qnx6/libset PATH=%QNXROOT%/host/win32/x86/usr/bin;%PATH%make -s all -f %1 CFG=WebServices CPU=x86

2. Replace $QNX_ROOT with QNX installation folder.

3. Open command line window and change directory to WebServices.

4. Run QNXCWWebServices.bat QNXCWWebServices.mak.

QNX Neutrino GCC:

1. Copy Rhapsody framework into QNX target.

2. Open terminal and change directory to WebServices.

3. Run: make -f QNXWebServices.mak QNXWebServices.a

Cygwin

1. Open command line and change directory to WebServices folder.

2. Run:..\etc\CygwinMake.bat cygwinWebServices.mak

Linux

1. Open terminal and change directory to WebServices.

2. Run: make -f linuxWebServices.mak

Nucleus

1. Open command line and change directory to WebServices folder.

2. Create a batch file with the following content:SET DIAB_ROOT=$DIAB_ROOTSET ATI_DIR=$ATI_DIRSET PATH=%DIAB_ROOT%\WIN32\BIN;%ATI_DIR%;%PATH%SET SHELL=dmake -f nuWebServices.mak BUILD_SET=Debug ATI_DIR=%ATI_DIR% CPU=$CPU CFG=WebServicesReplace the $DIAB_ROOT with the installation of diab , $ATI_DIR with the installation folder of ATI and $CPU with the requested CPU to compile.

3. Run the batch file.

Solaris

1. Copy framework files to Solaris machine.

2. Open terminal on Solaris machine and change directory to WebServices.

3. Run: make -f sol2WebServices.mak sol2WebServices.a

VxWorks

1. open VxWorks shell and change directory to WebServices.

2. Run: make all PATH_SEP=\ TOOL=$TOOL VX_VER=$VX_VER CFG=WebServices CPU=$CPU -f vxWebServices.makreplace $VX_VER with VxWorks version, $TOOL with the gnu\diab\sfdiab (in the case of sfdiab add parameter TOOL_FAMILY=diab) and $CPU with the target CPU.

3. Add USE_RTP=TRUE parameter in order to build the library for RTP application.

Web-enabling Rhapsody in Java models - building the WebComponentsDLL.dll library

1. Before building the library, make sure that you have used the Build Framework menu option to build the framework libraries, and that you have carried out the steps in this document for building the WebServices library.
2. Locate the file ..\Share\LangJava\src\webComponentsDLL.bat
3. Open the file for editing and make the following changes:
   • Modify the "set include" line to point to the \include and \include\win32 directories of your Java SDK, for example:
     set include=%include%;L:\java_ibm_71_32bit\sdk\include;L:\java_ibm_71_32bit\sdk\include\win32
   • Modify the line that calls vcvars32.bat so that it points to the correct directory for your Microsoft Visual Studio installation.
4. After making the changes to webComponentsDLL.bat, run the batch file.