HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
ADD_BACKUP
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
unsigned char backup_name[128]; /* name of backup server to add */
unsigned char reserv3[4]; /* reserved */
} ADD_BACKUP;
3.2.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_ADD_BACKUP
backup_name
The name of the server being added to the list of backup servers.
If the server name includes a . (period) character, SNAplus2 assumes that it is a fully-qualified name;
otherwise it performs a DNS lookup to determine the server name.
3.2.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
secondary_rc
Not used.
3.2.4 Returned Parameters: State Check
If the verb does not execute because of a state check, SNAplus2 returns the following parameters:
primary_rc
AP_STATE_CHECK
secondary_rc
Possible values are:
AP_DUPLICATE_RECORD
The server name specified is already listed in the file.
AP_INVALID_TARGET
The target handle on the NOF API call specified a configuration file or a node. This verb must be
issued to the sna.net file.
Appendix B,
Common Return Codes lists further secondary return codes associated with
AP_STATE_CHECK
, which
are common to all NOF verbs.
3.2.5 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.
84