HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
ADD_BACKUP
AP_INVALID_LU_ALIAS
The lu_alias parameter did not match any defined local LU alias.
AP_INVALID_LU_NAME
The lu_name parameter did not match any defined local LU name.
AP_INVALID_PLU_NAME
The fqplu_name parameter did not match any defined partner LU name, or the plu_alias parameter did
not match any defined partner LU name.
AP_INVALID_CNOS_PERMITTED
The value specified in the cnos_permitted parameter was not valid.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK,
which are common to all NOF verbs.
3.1.5 Returned Parameters: Activation Failure
If the verb does not execute because of other errors, SNAplus2 returns one of the following parameters.
primary_rc
Possible values are:
AP_ACTIVATION_FAIL_NO_RETRY
The session could not be activated because of a condition that requires action (such as a configuration
mismatch or a session protocol error). Check the SNAplus2 log file for information about the error
condition, and correct it before retrying this verb.
AP_ACTIVATION_FAIL_RETRY
The session could not be activated because of a temporary condition (such as a link failure). Retry
the verb, preferably after a timeout to allow the condition to clear. Check the SNAplus2 log file for
information about the error condition.
3.1.6 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.2 ADD_BACKUP
An application uses this verb to add a server to the list of backup master servers in the sna.net file, so that this
server can act as the master configuration file server if the current master becomes inactive. The new server is added
to the end of the list, so that it will only become the master if all the other servers listed in the file are inactive.
This verb must be issued to the sna.net file.
3.2.1 VCB Structure
typedef struct add_backup
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
83