Detailed information for the notes.ini Keyword: 

Restart_Time_Interval


Short Description: The maximum time difference allowed between the OS time and the Last_Domino_Time.

Description:

Use IBM® Lotus ® Domino's NOTES.INI settings to prevent the system clock on the Domino server from being reset to an incorrect time. The system clock time can be changed to an incorrect time, often to a future time, due to system or human error. These incorrect changes to a future time are called forward time changes. When a forward time change occurs on the system clock, all date and time stamps for all documents and databases also change.

There are two time settings impacted by forward time changes to the system clock settings. They are

  • Operating system (OS) time
  • Internal IBM Lotus Domino time

Forward time changes to the system clock can occur while the Domino server is running or while the server is shut down.

Use the following NOTES.INI settings to help prevent forward time changes.

  • Last_Domino_Time= Last recorded internal Domino time
  • Restart_Time_Interval= Value in seconds. The maximum time difference allowed between the OS time and the Last_Domino_Time. The default value is 3600 seconds.
  • Restart_Time_Action= Value of 1 indicates that restarting the Domino server is canceled and a message indicating this is written to the file NOTES.INI. If Restart_Time_Action= is set any value other than 1, the OS time is used.
  • Reset_Time_Interval= Value in seconds of the maximum time change allowed.

Note You can remove the value in the setting Last_Domino_Time, to force the Domino server to restart without failure after an extended amount of time regardless of the value in the Restart_Time_Action setting.

While the Domino server is shut down, Domino uses the NOTES.INI setting Last_Domino_Time to control forward time changes to the system clock. The previous internal Domino time is saved in Last_Domino_Time when the Domino server shuts down, when the server is successfully restarted and when the OS time refreshes the internal Domino time.

You can use the NOTES.INI setting Restart_Time_Interval to specify a restart time interval for the Domino server. When the Domino server restarts, if the difference between the OS time and the time stored in Last_Domino_Time exceeds the value in the NOTES.INI setting Restart_Time_Interval, one of the following occurs according to the settings in the NOTES.INI file:

  • If Restart_Time_Action=1, restarting the Domino server is canceled, and a message is written to the NOTES.INI file. If Restart_Time_Action= is set to any value other than 1, the OS time is used.
  • If any of the three NOTES.INI settings Last_Domino_Time, Restart_Time_Interval, or Restart_Time_Action are not set in the NOTES.INI file, the internal Domino time is reset to the OS time.
  • If Restart_Time_Action= and Restart_Time_Interval= have both been set in the NOTES.INI file, and if the Domino server is down for a period of time greater than the setting in Restart_Time_Interval, the Domino server does not restart.

While the Domino server is running, the internal Domino time is reset from the OS time at regular intervals. The server process issues a call to reset the internal Domino time every five minutes but other processes may also issue calls to reset the internal Domino time as well. Use the NOTES.INI setting, Reset_Time_Interval, to designate a maximum time interval other than the default of five minutes. Specify the time interval in seconds. The Reset_Time_Interval setting is checked when Domino attempts to reset the internal Domino time to the OS time. If the internal Domino time exceeds the Reset_Time_Interval, the OS time is not reset. For example, if the Reset_Time_Interval=600 (10 minutes), and the internal Domino time is 1:34 P.M., and the OS time is 1:12 P.M., issuing a Set SystemTime command would not readjust the internal Domino time.

Forcing internal domino time to reset to OS time

If the OS time exceeds the internal Domino time, you can use the server console command Set SystemTime to force the internal Domino time to be reset to the OS time regardless of the value of the NOTES.INI setting Reset_Time_Interval.





Default value:
3600

Syntax:
Restart_Time_Interval=seconds

Example:
Restart_Time_Interval=3600

UI equivalent:
There is no kown UI setting for this notes.ini variable. But you can specify this setting in the notes.ini settings tab of the configuration settings document.


Applies to:
Server


Valid for version:
8.0.0

Documented in:
Lotus Domino Administrator 8 Help

Entry created by:
IBM Documentation