DCE Application Programming Guide

Application Programming With NonStop DCE
Threads
HP NonStop DCE Application Programming Guide—429551-003
3-10
NonStop DCE Jacket Routines
A program using the SERVERCLASS_DIALOG_BEGIN_ jacket 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_DIALOG_BEGIN_ jacket routines.
SERVERCLASS_DIALOG_SEND_ Jacket
The DCE_SERVERCLASS_DIALOG_SEND_() function in the threads library is used to
send a message within the dialog and receive a reply from a server process in a
Pathway server class.
This jacket routine invokes a nowait version of the Guardian
SERVERCLASS_DIALOG_SEND_ procedure. The thread that makes the call is
suspended until the send operation has finished. The
DCE_SERVERCLASS_SEND_INFO_() function returns information about the last
DCE_SERVERCLASS_DIALOG_SEND_() call that was attempted or completed by the
current thread.
Like the DCE_SERVERCLASS_SEND_INFO_() jacket routine, the
DCE_SERVERCLASS_DIALOG_SEND_() 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.)
A program using the SERVERCLASS_DIALOG_SEND_ jacket 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_DIALOG_SEND_ jacket routines.
SERVERCLASS_DIALOG_END_ Jacket
The DCE_SERVERCLASS_DIALOG_END_() function in the threads library is used to
end the dialog corresponding to the dialog ID.
The DCE_SERVERCLASS_SEND_INFO_() function returns information about the last
DCE_SERVERCLASS_DIALOG_END_() call that was attempted or completed by the
current thread. See SERVERCLASS_SEND_INFO_ Jacket.
Like the DCE_SERVERCLASS_SEND_INFO_() jacket routine, the
DCE_SERVERCLASS_DIALOG_END_() jacket routine is released in a separate library