CkptFrequency
The CkptFrequency
connection attribute controls the frequency in seconds that TimesTen performs a background checkpoint.
The counter used for the checkpoint condition is reset at the beginning of each checkpoint.
If both CkptFrequency
and CkptLogVolume
attributes have a value greater than 0, a checkpoint is performed when either of the two conditions becomes true. The values set by the ttCkptConfig
built-in procedure replace the values set by these attributes.
In the case that your application attempts to perform a checkpoint operation while a background checkpoint is in process, TimesTen waits until the background checkpoint finishes and then executes the application's checkpoint.
When using TimesTen Scaleout, if Durability = 0,
set EpochInterval
to a value less than the value of the CkptFrequency
when Durability=0
to guarantee at least 1 epoch per interval.
The value of this attribute is "sticky" as it persists across database loads and unloads unless it is explicitly changed. The default value is only used during database creation. Subsequent first connections default to using the existing value stored in the database.
When the value of this attribute is more than 0
, if a checkpoint fails, TimesTen attempts a checkpoint once every 30 seconds. If a checkpoint failure occurs due to a lack of file system space, we recommend that you attempt a manual checkpoint as soon as space is available. Once any successful checkpoint occurs, background checkpointing reverts to the configured schedule.
Required Privilege
Only the instance administrator can change the value of this attribute.
Usage in TimesTen Scaleout and TimesTen Classic
This attribute is supported in both TimesTen Classic and TimesTen Scaleout.Setting
Set CkptFrequency
as follows:
Where to set the attribute | How the attribute is represented | Setting |
---|---|---|
C or Java programs or UNIX and Linux systems |
|
Enter a value in seconds for the frequency at which TimesTen should perform a background checkpoint. The default is If you do not specify this attribute with a value, TimesTen does not perform background checkpoints. For an existing database, TimesTen uses the stored value. |
Windows ODBC Data Source Administrator |
Not applicable |