WINTIME_RESYNC_PERIOD

General iProcess Engine Configuration

Summary

This attribute defines the interval (in seconds) at which iProcess Engine checks to see if its timestamps are in step with Windows system time.

Applies To

The attribute must be set for ALL processes.

Permissible Values

An integer that is greater than or equal to 0. If this attribute is set to 0 then no checks are performed.

Default Value

The attribute is assigned the following default value when the iProcess Engine node is installed.

Machine ID

Process

Instance

Value

0

ALL

0

300

Notes

The iProcess Engine node records audit trail timestamps to microsecond precision and sorts the audit trail based on the timestamp.

Because the Windows system timer only returns time to millisecond accuracy, the iProcess Engine node uses two system timers to generate its audit trail timestamps - the system timer (GetSystemTime function) and a high-resolution performance counter (QueryPerformanceCounter function) which can be used to provide extra precision. However, it has been found that these timers do not keep in step with each other, and can diverge by up to several seconds for days. This can result in two problems:

iProcess Engine timestamps do not correspond to the current Windows time when they are generated.
If BG processes are started at different times, any timestamps they generate will be out of synchronization with each other. This can result in audit trail entries appearing out of order.

To deal with these problems, you can use the WINTIME_RESYNC_* process attributes to configure how iProcess Engine synchronizes its timestamps with Windows system time.

Every WINTIME_RESYNC_PERIOD seconds iProcess Engine checks to see if its timestamps are in step with Windows system time. If the timestamps differ by more than WINTIME_RESYNC_TOLERANCE milliseconds iProcess Engine resynchronizes its timers with Windows system time. iProcess Engine processes are given WINTIME_RESYNC_NOTICE seconds notice before the resynchronization takes place.

Note: You can also manually force iProcess Engine to resynchronize its timestamps with Windows system time by using the swsvrmgr RESYNCTIME command. See Resynchronize Timestamps with Windows Time for more information.

See Also

WINTIME_RESYNC_NOTICE, WINTIME_RESYNC_TOLERANCE