HP-UX SNAplus2 MS Programmer's Guide

Writing MS Applications
Description of the MS API Entry Points
Chapter 2 33
Description of the MS API Entry Points
An application accesses the MS API using the following entry point
function calls:
ms
An application uses this entry point to issue an MS
verb synchronously. SNAplus2 does not return control
to the application until verb processing has finished.
All MS verbs except REGISTER_MS_APPLICATION
and REGISTER_NMVT_APPLICATION can be issued
through this entry point.
An application can use only this entry point if both of
the following conditions are true:
• The application only needs to send MS data using
the TRANSFER_MS_DATA verb or the
SEND_MDS_MU verb or both. (The application
does not need to receive MS data or status
indications.)
• The application can suspend while waiting for
SNAplus2 to completely process a verb.
The ms entry point is defined in the MS header file
ms_c.h.
ms_async
An application uses this entry point to issue an MS
verb asynchronously. SNAplus2 returns control to the
application immediately, with a returned value
indicating whether verb processing is still in progress
or has completed. If the returned value indicates that
verb processing is still in progress, SNAplus2 uses an
application-supplied callback routine to return the
results of the verb processing. If the returned value
indicates that verb processing is complete, the callback
routine will not be invoked.