HP-UX SNAplus2 R7 NOF Programmer's Guide

Writing NOF Applications

HP-UX Considerations

For more information about the parameters in the

NOF_CALLBACK structure, see Section 2.1.1, NOF API Entry Points

for HP-UX.

Supplied Parameters

An application supplies the following parameters when it uses the nof_async entry point:

target_handle

This parameter is supplied in one of the following ways:

• For the following verbs, this parameter is not used; 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 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 Chapter 3, NOF API Verbs. These structures are deﬁned in the NOF

API header ﬁle /usr/include/sna/nof_c.h.

Note

The NOF VCBs contain many parameters marked as “reserved”; some of these are

used internally by the SNAplus2 software, and others are not used in this version

but may be used in future versions. Your application must not attempt to access any

of these reserved parameters; instead, it must set the entire contents of the VCB to

zero to ensure that all of these parameters are zero, before it sets other parameters

that are used by the verb. This ensures that SNAplus2 will not misinterpret any of

its internally-used parameters, and also that your application will continue to work

with future SNAplus2 versions in which these parameters may be used to provide

new functions.

To set the VCB contents to zero, use memset:

memset(nofvcb, 0, sizeof(nofvcb));

comp_proc

The callback routine that SNAplus2 will call when the verb completes. For more information about the

requirements for a callback routine, see Section 2.1.1, NOF API Entry Points for HP-UX.

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, 32–bit integer, or 16–bit 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.