HP-UX SNAplus2 R7 NOF Programmer's Guide

Writing NOF Applications

Windows Considerations

AP_CORR corr

AP_UINT32 indic_length

);

typedef union ap_corr {

void * corr_p;

AP_UINT32 corr_l;

AP_INT32 corr_i;

} AP_CORR;

For more information about the parameters in the

NOF_CALLBACK

structure, see Section 2.2.1, NOF API Entry Points

for Windows.

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 ﬁle or 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 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