ASAP 1.1 Hybrid Manual

HP NonStop ASAP Hybrid Manual 529729-004
Page 4-5
The advantage of the static library is that it encapsulates ASAP functionality
within the given executable. This approach eliminates potential versioning
issues and makes it easy to move application executables from system to
system because no additional ASAP libraries are necessary. (However, the
ASAP Hybrid for Linux server must reside on each of those systems in order to
provide services to the client applications.) The disadvantage of using the
static library is that all client applications must be recompiled in order to use a
new version of the library, which can be problematic if a large number of
applications are affected.
The advantage of the shared library is that client applications do not have to
be recompiled in order to use new versions of the library. All new features are
immediately available to any applications that use the shared library. The
disadvantage of the shared library is that management of applications and
libraries becomes more complicated because the applications and libraries are
deployed independently of each other. This lack of coordinated deployment
can lead to issues with file placement, library search paths, and versioning.
After deciding which type of library to use, you must link the application to the
correct library file. Use the following table to determine the library file name for
your platform and environment:
Platform \ Library
Type
Static
Shared
32-bit
libasapx.a
libasapx.so
64-bit
libasapx64.a
libasapx64.so
If you choose to use a shared library and do not copy the library files to the
standard /usr/lib location, you need to modify the Linux dynamic loader’s search
path so that it can locate the library at run time. Update the /etc/ld.so.conf file,
or modify the LD_LIBRARY_PATH environment variable, to reference the
directory containing the library files. By default, this directory is lib in the original
ASAP Hybrid for Linux installation directory. For more information on default
installation locations, see Installing ASAP Hybrid for Linux.
Differences from NonStop ASAPX
Although the ASAP Hybrid for Linux API is nearly identical to the ASAPX API on
the NonStop server, there are some differences. In general, these changes were