set-flush Command

For Windows: Not Supported

The set-flush BASIC program displays or changes the value of the period of the flush and of the forced flush.

Syntax

set-flush {{period}{,force.period}} {(options}

set-flush {{period}{,off}} {(options}

set-flush {{period}{,imm}} {(options}

Parameter(s)

period

A new period (in seconds) with which the flush process wakes up automatically to write dirty (write-required) frames back to disk. The valid range is from 500 to 32000 milliseconds (0.5 to 32 seconds). If a period is not specified, the current flush period displays.

The default period is defined at boot time by the flush statement in the configuration file.

force.period

New period (in seconds) with which the flush process wakes up automatically to write all buffers containing data belonging to the file system (item, indexes, and so on). This period is the guaranteed time after which an update to a protected file is written to disk. These values have a special meaning:

0

All writes are done by the process itself. In other words, when a process updates an item, for example, the process waits until the write is completed. The keyword imm can be used to specify this option.

-1

Forced flush mechanism is disabled. With this option, there is no guaranteed time for an update to the file system to be written to disk. The keyword off can be used to specify this option.

options

q

Quiet mode suppresses all terminal output.

 

NOTE

The default period is defined at boot time by the fflush statement in the configuration file.

Example(s)

Indicates that the current flush period is set at 10 seconds, and the forced flush period is 5 seconds.

set-flush

Flush period 10 s. Forced flush period 5 s.

Sets the forced flush in immediate mode. The normal flush period is not changed.

set-flush ,imm

Flush period 10 s. Forced flush immediate.

Disables the forced flush in immediate mode and sets the normal flush period to 30 seconds.

set-flush 30,off

Flush period 30 s. Forced flush off.

See Also

%setflush() Function

buffers Command

buffers.g Command

flush Command

Flusher

user-coldstart Macro