RSC/MP 7.2 Programming Manual

Application Development

HP NonStop Remote Server Call (RSC/MP) Programming Manual—522360-004

6-5

Linking Windows 32-Bit RSC/MP Applications

RSC/MP applications for Windows should use the RSC/MP API library RSCW32.DLL.

The corresponding import library is RSCW32.LIB. These libraries support the

STDCALL calling convention, which is the standard used by the Windows API DLLs.

The RSC/MP API library (RSCW32.DLL or RSCNT.DLL) makes use of the Piccolo API

library (LIBPIPE.DLL) at runtime. It is not necessary to reference LIBPIPE.DLL during

the linking of a Windows RSC/MP application.

Linking UNIX RSC/MP Applications

The RSC/MP UNIX API is a shared library (librsc) which depends on the Piccolo API

library (libpipe). The following list shows the RSC/MP library files with their respective

UNIX platform:

The shared libraries are needed at build time in order to link the application, and also

at run time as they are loaded when the application is executed. Different UNIX

systems require different options to be passed to the linker when linking with shared

libraries. Please consult the documentation provided with your particular UNIX system

for details.

One common concern is the method by which the dynamic loader will locate librsc

and libpipe at run time. The dynamic loader’s operation is generally governed by

options that you specify when linking the executable. For example, the loader could

use a certain environment variable that can be set up at run time, or it could use an

absolute location where the libraries were located at link time — depending on the

options you supply during linking.

RSC/MP provides a sample makefile, rsctest.mak, which demonstrates the

environment variable method. This makefile can be used to rebuild the rsctest utility

or as a model set of linker options that you can use as a starting point and adapt for

use in your own application. If you use the same linker options as those used by

rsctest.mak, then the dynamic loader will search for librsc and libpipe in

Note. Earlier versions of the RSC/MP API library used the CDECL calling convention. For

compatibility with existing applications, RSC/MP provides the RSCNT.DLL run-time library

which supports CDECL. This library will be discontinued in a future version. Application

developers are urged to re-link their application with RSCW32.LIB, in order to use

RSCW32.DLL.

RSC/MP API Piccolo API

AIX librsc.o libpipe.o

HP-UX librsc.sl libpipe.sl

Linux librsc.so libpipe.so

SCO librsc.so libpipe.so

Solaris librsc.so.1 (library)

librsc.so (symbolic link)

libpipe.so.1 (library)

libpipe.so (symbolic link)