High Availability Monitors Version A.03.02 Release Notes

Writing NOF Applications
Description of the NOF API Entry Points
Chapter 2 91
Description of the NOF API Entry Points
An application accesses the NOF API using the following entry point
function calls:
nof
Issues a NOF verb synchronously. SNAplus2 does not
return control to the application until verb processing
has finished. All NOF verbs except
REGISTER_INDICATION_SINK and
UNREGISTER_INDICATION_SINK can be issued
through this entry point.
An application can use only this entry point if the
application can suspend while waiting for SNAplus2 to
completely process a verb.
The nof entry point is defined in the NOF header file
nof_c.h.
nof_async
Issues a NOF 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. In
cases when SNAplus2 is able to completely process the
request, the callback routine will not be invoked.
All NOF verbs can be issued through this entry point.
The REGISTER_INDICATION_SINK and
UNREGISTER_INDICATION_SINK 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 NOF indications.
• The application cannot suspend while waiting for
SNAplus2 to completely process a verb.