4D Doc Center : On Backup Shutdown database method

4D v14.3

On Backup Shutdown database method


$1 -> On Backup Shutdown database method

Parâmetro	Tipo	Descrição
$1	Inteiro longo	0 = backup executed correctly; other value = error, interrupted by user or code returned by On Backup Startup

O On Backup Shutdown database method é chamado a cada vez que o backup do banco de dados termina. As razões para deter um backup podem ser o fim da cópia, interrupção por parte do usuário ou um erro.

Isto envolve todos os ambientes 4D (todos os modos), 4D Server, bem como os aplicativos 4D compilados e fusionados com 4D Volume Desktop.

O On Backup Shutdown database method permite verificar que o backup foi executado corretamente. Ele recebe o parâmetro $1, um valor representando o status do backup uma vez que ele tenha sido finalizado:

Se o backup foi executado corretamente, $1 é igual a 0.
Se o backup foi interrompido pelo usuário ou ocorreu um erro, $1 é diferente de 0.
- Se o backup foi parado pelo Método de Banco de Dados On Backup Startup ($0 # 0), $1 obtém o valor devolvido no parâmetro $0. Isto lhe permite implementar um sistema de gerenciamento de erros personalizados
- Se o backup foi parado por um erro, o código do erro é devolvido em $1.

Em todos os casos, pode obter informação sobre o erro utilizando o comando GET BACKUP INFORMATION.

Nota: Você deve declarar o parâmetro $1 (inteiro longo) no método do banco de dados:

C_LONGINT($1)

É importante notar que no caso de erro durante o backup (disco cheio, suporte inacessível, etc.), a informação relativa ao erro é mostrada unicamente no monitor de 4D Server ou no CSM, e é copiado no histórico de backups. Não é mostrada uma caixa de diálogo de alerta e a variável erro não se modifica. Se deseja notificar ao administrador que se produziu um erro, particularmente no contexto de uma aplicação em modo cliente/servidor, é necessário utilizar o On Backup Shutdown database method.