HP-UX SNAplus2 R7 NOF Programmer's Guide

Writing NOF Applications
HP-UX Considerations
2 Writing NOF Applications
This chapter describes the following:
UNIX
• HP-UX considerations
• NOF API entry points for HP-UX
• Compiling and linking the NOF application
WINDOWS
• Windows considerations
• NOF API entry points for Windows
• Compiling and linking the NOF application
• Writing portable applications
• Target (node or file) for NOF verbs, and how they interact with the target
• Ordering and dependencies between NOF verbs
• NOF restrictions based on node configuration
• How to request single or multiple data entries with QUERY_* verbs
2.1 HP-UX Considerations
UNIX
This section describes operating system issues that you need to consider when writing NOF applications for use in
the HP-UX environment.
2.1.1 NOF API Entry Points for HP-UX
An application accesses the NOF API using the following entry point function calls:
nof
Issues a NOF verb synchronously. SNAplus2 does not return control to the application until verb
processing has finished. All NOF verbs except REGISTER_INDICATION_SINK and UNREGIS-
TER_INDICATION_SINK can be issued through this entry point.
An application can use this entry point only if the application can suspend while waiting for SNAplus2 to
completely process a verb.
nof_async
Issues a NOF verb asynchronously. SNAplus2 returns control to the application immediately, with a returned
value indicating whether verb processing is still in progress or has completed. If the returned value indicates
that verb processing is still in progress, SNAplus2 uses an application-supplied callback routine to return the
63