The delete_backup command deletes a server from the list of servers in the sna.net file; this server can no longer act as the master configuration
file server.
You can use this command to delete any server in the list,
including the master server, whether or not the SNA software is
running on the server you are deleting. The only restriction is
that the list must always contain at least one server on which the
SNA software is running (so that this server can take over as the
master server). You cannot delete a server if it is the only server
in the list or if it is the only server listed on which the SNA
software is running.
This command must be issued without specifying a node name.
Supplied Parameters |
 |
Parameter name Type Length
[delete_backup]
backup_name character 64
|
Supplied parameter is:
- backup_name
The name of the server to be deleted from the list
of backup servers.
Returned Parameters |
|
No parameters are returned by SNAplus2 when this command executes successfully.
Error Return Codes |
|
If the command cannot be executed, SNAplus2 returns a primary
return code to indicate the type of error and a secondary return
code to provide specific details about the reason for unsuccessful
execution.
No parameter errors occur for this command.
If the command does not execute because of a state error,
SNAplus2 returns the following parameters:
- primary_rc
STATE_CHECK
- secondary_rc
Possible values are:
- RECORD_NOT_FOUND
The server name specified in the backup_name parameter is not listed in the file.
- CANT_DELETE_LAST_BACKUP
The server name cannot be deleted from the list because
it is the only server listed on which the SNA software is running
(the only server that can currently act as the master server). Before
attempting to delete the server, either start the SNA software on
one or more of the other servers listed, or add one or more new backup
servers (using add_backup) and ensure that the SNA software is started on these
servers.
Printable version
