El Método de base de datos On Backup Shutdown se llama cada vez que termina un backup de la base. Las razones para detener un backup pueden ser el fin de la copia, la interrupción por parte del usuario o un error.
Esto concierne a todos los entornos 4D (todos los modos), 4D Server así como las aplicaciones 4D compiladas y fusionadas con 4D Volume Desktop.
El Método de base de datos On Backup Shutdown permite verificar que el backup fue ejecutado correctamente. El método recibe, en el parámetro $1, un valor indicando el estado del backup una vez terminado:
- Si el backup se ejecutó correctamente, $1 es igual a 0.
- Si el backup fue interrumpido por el usuario o por un error, $1 es diferente de 0.
- Si el backup fue detenido por el Método de base de datos On Backup Startup ($0 # 0), $1 obtiene el valor devuelto en el parámetro $0. Esto le permite implementar un sistema de gestión de errores personalizado.
- Si el backup fue detenido por un error, el código del error se devuelve en $1.
En todos los casos, puede obtener información sobre el error utilizando el comando
GET BACKUP INFORMATION.
Nota: debe declarar el parámetro $1 (entero largo) en el método de la base:
C_LONGINT($1)
Es importante notar que en caso de error durante el backup (disco lleno, soporte inaccesible, etc.), la información relativa al error se muestra únicamente en el monitor de 4D Server o en el CSM, y se copia en el historial de backups. No se muestra una caja de diálogo de alerta y la variable error no se modifica. Si quiere notificar al administrador que se produjo un error, particularmente en el contexto de una aplicación en modo cliente/servidor, es necesario utilizar el Método de base de datos On Backup Shutdown.