High Availability Monitors Version A.03.02 Release Notes

Writing NOF Applications
Description of the NOF API Entry Points
Chapter 2 95
yet started)
— OPEN_FILE (to access the domain configuration
fileor the SNA network data file)
• For the following verbs, the application supplies a
null value:
— QUERY_NODE_ALL (to obtain a list of running
nodes)
— QUERY_CENTRAL_LOGGER
• For all other NOF verbs, the application supplies
the value that was returned on the
CONNECT_NODE or OPEN_FILE verb.
nofvcb 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 Chapters 3, 4,
and 5. These structures are defined in the NOF API
header file nof_c.h.
comp_proc The callback routine that SNAplus2 will call when the
verb completes. For more information about the
requirements for a callback routine, see “The Callback
Routine Specified on the nof_async Entry Point”.
corr An optional correlator for use by the application. This
parameter is defined as a C union so that the
application can specify any of three different
parameter types: pointer, unsigned long, or integer.
SNAplus2 does not use this value, but passes it as a
parameter to the callback routine when the verb
completes. This value enables the application to
correlate the returned information with its other
processing.
Returned Values
The asynchronous entry point returns one of the following values:
AP_COMPLETED
The verb has already completed. The application can
examine the parameters in the VCB to determine
whether the verb completed successfully. SNAplus2