enableProgressEvents

enableProgressEvents(increment: Integer);

The enableProgressEvents method of the JadeDatabaseAdmin class enables the notification of operation and progress events for file backups at the progress interval specified in the increment parameter, which represents a percentage of the size of the file.

When operation and progress event notifications are enabled:

For details, see "JadeDatabaseAdmin Class Event Notifications" and "DbFile Class Event Notifications", elsewhere in this chapter.

The following example shows the use of the enableProgressEvents method.

initialise(backupDir: String;
           compress, verify, includeSystemFiles: Boolean;
           overwrite, quiesce: Boolean) updating;
begin
    // Save backup parameters for calls to database backup methods
    defaultDirectory := backupDir;
    compressFiles    := compress;
    verifyFiles      := verify;
    includeSysFiles  := includeSystemFiles;
    overwriteFiles   := overwrite;
    quiescedBackup   := quiesce;
    // Enable backup progress events to occur in increments of 4% or greater
    self.dba.enableProgressEvents(4);
end;

Enabling operation and progress notification is likely to have some impact on the elapsed time of file backups.