HP-UX SNAplus2 MS Programmer's Guide

Writing MS Applications
Description of the MS API Entry Points
Chapter 2 35
For the UNREGISTER_MS_APPLICATION,
UNREGISTER_NMVT_APPLICATION, and
DISCONNECT_MS_NODE verbs, the application
supplies the value that was returned on the
CONNECT_MS_NODE verb. This parameter is used to
identify the target SNAplus2 node.
For all other verbs, this parameter is not used; set it to
0 (zero).
msvcb
Pointer to a Verb Control Block (VCB) that contains the
parameters for the verb being issued. The VCB
structure for each verb is described in Chapter 3,
“Management Services Verbs.” These structures are
defined in the MS API header file ms_c.h.
Returned Values
The ms entry point does not have a return value. When the call returns,
the application should examine the return code in the VCB to determine
whether the verb completed successfully and to determine parameters it
needs for further verbs. In particular, when the CONNECT_MS_NODE
verb completes successfully, the VCB contains the target_handle that
the application should use when the application issues subsequent verbs.
Using the Synchronous Entry Point
Only one synchronous verb can be outstanding at any time for each
target handle. A synchronous verb fails with the primary return code
AP_STATE_CHECK and secondary return code AP_SYNC_PENDING if
another synchronous verb for the same target handle is in progress.
Asynchronous Entry Point: ms_async
An application uses ms_async to issue an MS verb asynchronously. The
application also supplies a pointer to a callback routine. SNAplus2
returns control to the application immediately with a returned value
that indicates whether verb processing is still in progress or has
completed. In most cases, verb processing is still in progress when
control returns to the application. In these cases, SNAplus2 uses the
application-supplied callback routine to return the results of the verb