4D v13.4
On Backup Shutdown database method
- 4D Language Reference
-
- Database Methods
-
- Database Methods
- On Backup Shutdown database method
- On Backup Startup database method
- On Drop database method
- On Exit database method
- On Server Close Connection database method
- On Server Open Connection database methodUpd
- On Server Shutdown database method
- On Server Startup database method
- On SQL Authentication database method
- On Startup database method
- On System Event database methodNew
- On Web Authentication database methodUpd
- On Web Connection database method
- On Web Session Suspend database methodNew
On Backup Shutdown database method
| $1 -> On Backup Shutdown database method | ||||||||
| Parameter | Type | Description | ||||||
| $1 | Longint |
|
0 = backup executed correctly; other value = error, interrupted by user or code returned by On Backup Startup | |||||
The On Backup Shutdown database method is called every time a database backup ends. The reasons for the stoppage of a backup can be the end of the copy, user interruption or an error.
This concerns all 4D environments: 4D (all modes), 4D Server as well as 4D applications compiled and merged with 4D Volume Desktop.
The On Backup Shutdown database method allows verifying that the backup was executed correctly. It receives, in the $1 parameter, a value representing the status of the backup once completed:
- If the backup was executed correctly, $1 equals 0.
- If the backup was interrupted by the user or following an error, $1 is different from 0.
- If the backup was stopped by the On Backup Startup Database Method ($0 # 0), $1 gets the value actually returned in the $0 parameter. This allows you to implement a customized error management system.
- If the backup was stopped due to an error, the error code is returned in $1.
Note: You must declare the $1 parameter (longint) in the database method:
C_LONGINT($1)It is important to note that in the case of an error during backup (disk full, support unavailable, etc.), the information related to the error is only displayed in the 4D Server monitor or in the MSC, and copied into the backup log. No alert dialog box appears and the error variable is not modified. If you want to be able to notify the administrator that an error has occurred, particularly in the context of an application running in client/server mode, you will need to use the On Backup Shutdown database method.
Product: 4D
Theme: Database Methods
