D3Codex
TCL

database-pause command

.md

The database-pause command temporarily suspends disk writes to allow for external backups (or snapshots) of disks to be taken.

Note: The database-pause command is not available on D3 Windows.

Syntax

 database-pause {(options}

Parameter(s)

options n Pauses the database.

When a database-pause is in effect, users can continue to work and update files. File updates are cached in memory and once disk writes are resumed, the memory will be flushed to disk.
w{seconds} Specifies to wait up to one hour before pausing the database to allow all memory to be flushed before disabling disk writes.

The optional seconds specifies an alternate amount of time to wait (in seconds) for memory to be flushed.

Note: This option only applies when a database-pause command with the n option is in effect .

Description

If no options are specified, the status is returned. The status indicates whether or not a pause or wait condition is in effect.

When the database is in pause mode, if a memory full condition is detected, disk writes will automatically resume after the number of seconds specified in the dbresumetime value configured in pick0 file.

For example: dbresumetime {seconds}). Note that when you set this value, a system restart is required for the value to take effect.

Disk writes can be resumed using the database-resume command.

Note: If D3 is shut down when the system is in a paused state, the database will automatically be resumed to ensure that all updates are written.

See also

database-resume command→pick0 file→