DCE Application Programming Guide

Application Programming With NonStop DCE
Threads
HP NonStop DCE Application Programming Guide—429551-003
3-9
NonStop DCE Jacket Routines
These jacket routines are not included in the standard DCE shared run-time library but
are released in a separate library that can be statically bound to an application that
needs them.
This library is named libdce_scs.a and is installed in /usr/lib. Installing a
TNS/R version of NonStop DCE can cause the TNS version of this library to be
relocated or removed. If you need to continue using the TNS version of this library,
check with your DCE administrator for its correct location in a specific virtual host. (This
issue does not affect the TNS/E version of NonStop DCE because the OSS
environment on TNS/E systems does not support TNS execution.)
A program using the SERVERCLASS_SEND_ jackets is built using at least two
libraries—a static library for the jackets and a dynamic library for the rest of the DCE
functions. For example:
/nonnative/bin/c89 -o program program.o -l dce_scs -l dce
Appendix C, NonStop DCE Jacket Functions, contains reference information for the
SERVERCLASS_SEND_ jacket routines.
SERVERCLASS_SEND_INFO_ Jacket
The DCE_SERVERCLASS_SEND_INFO_() function ensures that the thread gets the
information for the last message sent by the thread rather than by the process. This
jacket routine is not included in the standard DCE shared run-time library but is
released in a separate library that can be statically bound to an application that needs
it.
SERVERCLASS_DIALOG_BEGIN_ Jacket
The DCE_SERVERCLASS_DIALOG_BEGIN_() function in the threads library is used to
initiate the dialog and send the first message of the dialog to the server process in the
Pathway server class.
This jacket routine invokes a nowait version of the Guardian
SERVERCLASS_DIALOG_BEGIN_ procedure. The thread that makes the call is
suspended until the begin operation has finished. The
DCE_SERVERCLASS_SEND_INFO_() function returns information about the last
DCE_SERVERCLASS_DIALOG_BEGIN_() call that was attempted or completed by the
current thread.
Like the DCE_SERVERCLASS_SEND_INFO_() jacket routine, the
DCE_SERVERCLASS_DIALOG_BEGIN_() jacket routine is released in a separate
library that can be statically bound to an application that needs it. See
SERVERCLASS_SEND_INFO_ Jacket. This library is named libdce_scs.a and is
installed in /usr/lib. Installing a TNS/R version of NonStop DCE can cause the TNS
version of this library to be relocated or removed. If you need to continue using the
TNS version of this library, check with your DCE administrator for its correct location in
a specific virtual host. (This issue does not affect the TNS/E version of NonStop DCE
because the OSS environment on TNS/E systems does not support TNS execution.)