HP-UX SNAplus2 NOF Programmer's Guide

Writing NOF Applications
Description of the NOF API Entry Points
Chapter 290
The nof_async entry point is defined in the NOF
header file nof_c.h.
nof_async callback routine
When using the asynchronous NOF API entry point,
the application must supply a pointer to a callback
routine. SNAplus2 uses this callback routine both for
completion of a verb and also for returning NOF data
and status indications.
Synchronous Entry Point: nof
An application uses the nof entry point to issue a NOF verb
synchronously. SNAplus2 does not return control to the application until
verb processing has finished.
Function Call
void nof (
AP_UINT32 target_handle,
void * nofvcb
);
Supplied Parameters
An application supplies the following parameters when it uses the nof
entry point:
target_handle An identifier that the application uses to identify the
target SNAplus2 node or file. This parameter is
supplied in one of the following ways:
• For the following verbs, this parameter is not
supplied; set it to 0 (zero). If the verb completes
successfully, SNAplus2 returns the target handle
as one of the VCB parameters. The application
then uses the target handle for subsequent verbs.
— CONNECT_NODE (to access a running node,
or to access the node on a server where the
SNAplus2 software is started but the node is
not yet started)
— OPEN_FILE (to access the domain
configuration fileor the SNA network data file)