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.
VCB
Structure |
 |
typedef struct add_backup
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
unsigned char backup_name[64]; /* name of backup server to add */
unsigned char reserv4[4]; /* reserved */
} ADD_BACKUP;
|
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.
Returned
Parameters: Successful Execution |
|
If the verb executes successfully, SNAplus2 returns the following parameters:
- primary_rc
AP_OK
- secondary_rc
Not used.
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 A “Common
Return Codes” lists further
secondary return codes associated with AP_STATE_CHECK,
which are common to all NOF verbs.
Returned
Parameters: Other Conditions |
|
Appendix A “Common
Return Codes” lists further
combinations of primary and secondary return codes that are common
to all NOF verbs.
Printable version
