HP-UX SNAplus2 MS Programmer's Guide

Writing MS Applications
Description of the MS API Entry Points
Chapter 234
All MS verbs can be issued throught this entry point.
The REGISTER_MS_APPLICATION and
REGISTER_NMVT_APPLICATION verbs must be
issued through this entry point.
An application must use this entry point if either of the
following conditions is true:
• The application needs to receive MS data and
status indications.
• The application cannot suspend while waiting for
SNAplus2 to completely process a verb.
The ms_async entry point is defined in the MS header
file ms_c.h.
Callback routine for ms_async
An application must supply a pointer to a callback
routine when it uses the asynchronous MS API entry
point. SNAplus2 uses this callback routine both for
completion of a verb and also for returning MS data
and status indications.
Synchronous Entry Point: ms
An application uses ms to issue an MS verb synchronously. SNAplus2
does not return control to the application until verb processing has
finished.
Function Call
void ms (
unsigned long target_handle,
void * msvcb
);
Supplied Parameters
An application supplies the following parameters when it uses the ms
entry point:
target_handle