Library Version 12.1.6.2

DbEnv::set_backup_config()
Prev | Chapter 5. The DbEnv Handle | Next

## DbEnv::set_backup_config()

    #include <db_cxx.h>

    DB_ENV->set_backup_config(DB_BACKUP_CONFIG option, u_int32_t value);

The `DbEnv::set_backup_config()` method configures tuning parameters for the hot backup APIs. See the DbEnv::backup() and DbEnv::dbbackup() methods for a description of the hot backup APIs.

The `DbEnv::set_backup_config()` method configures operations performed using the specified DbEnv handle, not all operations performed on the underlying database environment.

The `DbEnv::set_backup_config()` method may be called at any time during the life of the application.

The `DbEnv::set_backup_config()` method either returns a non-zero error value or throws an exception that encapsulates a non-zero error value on failure, and returns 0 on success.

### Parameters

#### option

The option parameter identifies the backup parameter to be modified. It must be one of the following:

- `DB_BACKUP_WRITE_DIRECT`

  Turning this on causes direct I/O to be used when writing pages to the disk. For some environments, direct I/O can provide faster write throughput, but usually it is slower because the OS buffer pool offers asynchronous activity.

  By default, this option is turned off.

- `DB_BACKUP_READ_COUNT`

  Configures the number of pages to read before pausing. Increasing this value increases the amount of I/O the backup process performs for any given time interval. If your application is already heavily I/O bound, setting this value to a lower number may help to improve your overall data throughput by reducing the I/O demands placed on your system.

  By default, all pages are read without a pause.

- `DB_BACKUP_READ_SLEEP`

  Configures the number of microseconds to sleep between batches of reads. Increasing this value decreases the amount of I/O the backup process performs for any given time interval. If your application is already heavily I/O bound, setting this value to a higher number may help to improve your overall data throughput by reducing the I/O demands placed on your system.

- `DB_BACKUP_SIZE`

  Configures the size of the buffer, in bytes, to read from the database. Default is 1 megabyte.

#### value

The value parameter sets the configuration value for the option identified by the option parameter. For those options which can only be turned on or off, this parameter should be set to `0` for off and `1` for on. Otherwise, set this parameter to an integer value that represents the number of units for which you are configuring the backup APIs.

### Class

DbEnv,

### See Also

Database Environments and Related Methods, DbEnv::get_backup_config(), DbEnv::backup(), DbEnv::dbbackup()

Prev | Up | Next
DbEnv::set_backup_callbacks() | Home | DbEnv::set_data_dir()