8.182 TIMERINT (Display or set timers update interval)

8.182.1 Function

The TIMERINT parameter displays or sets the internal timer update interval in microseconds. This para-
meter specifies how frequently Hercules's internal timers-update thread updates the TOD clock, CPU
Timer and other architectural related clock and timer values.

The default interval is 50 microseconds which attempts to strike a reasonable balance between clock
accuracy and overall host performance.

8.182.2 Syntax

Descriptive

]

Diagram

¬¬¬¬ ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

8.182.3 Parameter

interval

Specifies the timer update interval in microseconds. The minimum allowed value for
the interval is 1 microsecond and the maximum is 1'000'000 microseconds (one se-
cond.

CAUTION: While a lower TIMERINT value may help increase the accuracy of the
guest's TOD clock and CPU Timer values, it could also have severe negative im-
pact on the overall performance of the host operating system. This is especially
true when a low value is coupled with a high HERCPRIO and TODPRIO priority
setting.

Exercise extreme caution when choosing your desired TIMERINT in relationship to
your chosen HERCPRIO and TODPRIO priority settings.

8.182.4 Examples

Example 1:

Display current timers update interval.

HHC00013I Herc command: 'timerint'

HHC02203I timerint : 50

Figure 323: TIMERINT command (list current value)

Example 2:

Set timers update interval to 100 microseconds.

HHC00013I Herc command: 'timerint 100'

HHC02204I timerint set to 100

Figure 324: TIMERINT command (set new value)