HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
CONNECT_NODE
3.7.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_CONNECT_NODE
node_type
To connect to a particular node in order to manage the node’s configuration, set this parameter to
AP_SPECIFIED_NODE.
To connect to the node currently acting as the central logger, set this parameter to AP_CENTRAL_LOGGER.
This value is required if the application will be issuing the following verbs:
• SET_CENTRAL_LOGGING, QUERY_CENTRAL_LOGGING
• SET_GLOBAL_LOG_TYPE, QUERY_GLOBAL_LOG_TYPE
• SET_LOG_FILE, QUERY_LOG_FILE (if central logging is in use)
node_name
Name of the SNAplus2 node to connect to. This parameter is reserved if node_type is set to
AP_CENTRAL_LOGGER.
If the node name includes a . (period) character, SNAplus2 assumes that it is a fully-qualified name; otherwise
it performs a DNS lookup to determine the node name.
If SNAplus2 is running with all components on a single computer, you can set this parameter to all binary
zeros; there is no need to specify the node name. Otherwise, setting this parameter to all binary zeros indicates
the default local node (on the same SNAplus2 server as the application).
3.7.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
secondary_rc
Not used.
target_handle
Returned value for use on subsequent verbs.
node_status
Specifies the status of the node. Possible values are:
AP_NDE_STARTING
The node is in the process of being activated.
AP_NDE_STARTED
The node is active.
AP_NDE_STOPPING
The node is in the process of being deactivated.
AP_NDE_STOPPED
The node is not active.
99