HP-UX SNAplus2 R7 NOF Programmer's Guide

Writing NOF Applications
HP-UX Considerations
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.
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.
The nof and nof_async entry points are defined in the NOF header file /usr/include/sna/nof_c.h.
Parameter types such as AP_UINT32, used in these entry points and in the NOF VCBs, are defined in the common
header file /usr/include/sna/values_c.h, which is included by the NOF header file nof_c.h.
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)
• 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 Chapter 3, NOF API Verbs. These structures are defined in the NOF
API header file /usr/include/sna/nof_c.h.
64