HP-UX SNAplus2 NOF Programmer's Guide

Writing NOF Applications
Target For NOF Verbs
Chapter 2 105
Target For NOF Verbs
A NOF verb can be directed to any of the following targets:
• A running node (to manage the node's resources)
• The node on a server where the SNAplus2 software is running but
where the node has not been started (to start the node, to query the
node's stored configuration, or to modify the configuration so that the
changes take effect when the node is restarted)
• The domain configuration file (to manage domain resources)
• The sna.net file (to manage the SNAplus2 servers that can act as
backup masters if the master server is not available)
The target for a particular NOF verb is identified by the target_handle
parameter used on the NOF call. An application acquires a target handle
using different NOF verbs depending on the target, as follows:
Running node or node on running server
The application issues CONNECT_NODE, specifying
the name of the required node, with a null target
handle; SNAplus2 returns a target handle for this node
as one of the VCB parameters for CONNECT_NODE.
Domain configuration file
The application issues OPEN_FILE with a null target
handle; SNAplus2 returns a target handle for the file
as one of the VCB parameters for OPEN_FILE.
sna.net file
The application issues OPEN_FILE with a null target
handle; SNAplus2 returns a target handle for the file
as one of the VCB parameters for OPEN_FILE.
Some NOF verbs can be issued only to particular target types:
• DEFINE_NODE cannot be issued to a running node; it must be
issued to a server where the node is not running.
• Verbs associated with node resources, such as DEFINE_LOCAL_LU,
must be issued to a node.