Previous Page Contents Page Next Page

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                       */
      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    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.

3.2.3 Returned Parameters: Successful Execution

If the verb executes successfully, SNAP-IX 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, SNAP-IX 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.

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

Common Return Codes lists further combinations of primary and secondary return codes that are common to all NOF verbs.

Previous Page Contents Page Top of Page Next page