HP-UX SNAplus2 NOF Programmer's Guide

Writing NOF Applications

Description of the NOF API Entry Points

Chapter 2 93

— 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

conﬁguration ﬁleor the SNA network data ﬁle)

• 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 deﬁned in the NOF API

header ﬁle 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 Speciﬁed on the nof_async Entry Point”.

corr

An optional correlator for use by the application. This

parameter is deﬁned 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