home *** CD-ROM | disk | FTP | other *** search
/ nisttime.carsoncity.k12.mi.us / nisttime.carsoncity.k12.mi.us.tar / nisttime.carsoncity.k12.mi.us / pub / daytime / README.UPDATE < prev    next >
Text File  |  2010-05-14  |  12KB  |  229 lines
  1. nistime-32bit.exe version 3.40
  2.  
  3.    This version corrects a problem with writing time differences
  4. and error messages to the log file (named nistime.dif by default). 
  5. The previous versions did not completely close the file after 
  6. each write, so that the system resources for opening files
  7. were exhausted after the program had been running for some time. 
  8. This generally happened after about 50 writes to the log file. 
  9. The program continued to run once this happened, but it could no 
  10. longer write to the log file. 
  11.  
  12. nistime-32bit.exe version 3.31
  13.  
  14.   This version adds an error message if a user who does not have
  15. administrator privileges tries to use the program to adjust the 
  16. system time. The request will be ignored by the Windows system. 
  17. The previous version of the program did not provide an error 
  18. message in this case. (The restriction that only a user with 
  19. administrator privileges can adjust the system clock generally 
  20. does not apply to versions of Windows before Win 2000.) A user
  21. without administrator privileges can use the program to compare
  22. the time of the system with the NIST server. The error message
  23. will appear only if the user tries to use the data to adjust
  24. the local clock.
  25.  
  26. nistime-32bit.exe version 3.15
  27.  
  28.   This version adds a new parameter to the command line that can be used
  29. to delay the start of the program. If the switch -s<number> is present
  30. on the command line, the program will start as soon as the command is
  31. processed, but it will not actually do anything for the number of seconds 
  32. specified by "number." Thus the switch -s60 will cause the program to start 
  33. but not to do anything for one minute.
  34.   This can be used to give a network connection time to be established, for
  35. example. This switch may be required if the program is placed in the Windows
  36. startup folder. If it is not used in this case, the program may try and query 
  37. a time server before the network connection is established. 
  38.    There will be no display or other sign of activity during this initial 
  39. sleep period. The actual sleep time may differ from the specified value by 
  40. up to 1 second.
  41.  
  42. nistime-32bit.exe version 3.14
  43.  
  44.   This version ignores the Winsock returned (non-zero) status code 
  45. WSABASEERR.  Some versions of Winsock may return this status code even 
  46. when the operation succeeded. The previous version treated any 
  47. non-zero code as an error, which is the standard Winsock convention.
  48.  
  49. nistime-32bit.exe version 3.13
  50.  
  51.    This version corrects a problem with the network delay calculation
  52. when the program queries a server using NTP format. The previous 
  53. version sometimes computed the delay incorrectly when the actual 
  54. delay was less than 10 milliseconds. This error in the calculation 
  55. of the network delay also resulted in an incorrect value for the 
  56. computed time difference between the client and the server. This
  57. error did not always occur, and the probability of it happening
  58. increased as the actual network delay became shorter.
  59.  
  60. nistime-32bit.exe version 3.12
  61.  
  62.    This version includes fixes for two problems:
  63.  
  64.    1. If the program was stored in a directory whose path had an 
  65. embedded space (such as c:\Program Files\ ...), the previous version 
  66. did not handle this situation correctly in all circumstances.  This 
  67. problem could affect both the configuration file and the file used 
  68. to store time differences and error messages. 
  69.  
  70.    2. When a system shutdown request is received, the exit status of 
  71. the program has been changed to prevent the program from interfering
  72. with the shutdown process. The previous version could prevent the
  73. system from shutting down in certain circumstances. This interference
  74. was most commonly observed when the program was operating in "quiet
  75. mode," but it could also affect a shutdown when the program was
  76. running in the foreground with the screen display enabled.
  77.  
  78.  
  79. nistime-32bit.exe version 3.11
  80.  
  81.    This version includes fixes for two problems:
  82.  
  83.    1. Changing back and forth between the daytime and NTP formats
  84. on the same server without saving the changed configuration and 
  85. restarting the program. The previous version did not handle this 
  86. correctly.
  87.  
  88.    2. Using a long path name to store the program itself or one
  89. of its configuration files. The previous version did not check
  90. for a name that was longer than the assigned array.
  91.  
  92. nistime-32bit.exe version 3.1
  93.  
  94. In addition to several new help messages and small improvements to the 
  95. internal code, this version has two significant changes from the previous 
  96. version:
  97.  
  98.    1. This version allows you to store the configuration file and
  99. the file containing the list of NIST servers either in the Windows
  100. system directory (usually c:\windows or c:\winnt) or in the same
  101. directory as you use to store the program itself. (The previous
  102. versions always stored these files in the Windows system directory.)
  103. The directory where the program itself is stored is used by default.
  104. You can change this behavior using an option on the File menu of
  105. the program.  The program will search both of these locations each
  106. time it starts, and will use the files in its home directory if
  107. they exist both there and in the Windows system directory. Thus
  108. this new version is completely compatible with the previous version,
  109. and no change is necessary to read files generated by a previous
  110. version. However, this version will write new configuration files
  111. to its home directory by default.
  112.  
  113.    2. This version supports operation in the background, which is
  114. called "quiet" mode. The program runs completely in the background
  115. in this mode -- it does not have any display and will not accept input 
  116. from the keyboard or the mouse. Once it is started in this way it will 
  117. continue to run in the background until the system is halted or the 
  118. program itself is stopped using the task manager.  This option may be 
  119. selected in two ways: either by adding the parameter "quiet" to the 
  120. command line or by checking a box on the periodic queries menu. Look 
  121. at the Help | Quiet mode entry for more information about this choice. 
  122. (Note that this mode is very similar to a Windows NT "service.")  When 
  123. using this option, keep in mind that the program requires a connection
  124. to the Internet to query our servers, and that it may not work very well 
  125. if you connect to the Internet using a dial-up telephone call to an 
  126. Internet Service Provider.
  127.  
  128.    The 16-bit version of the program has not been changed.
  129.  
  130. nistime-32bit.exe version 3.0
  131.  
  132.     The file nistime-32bit.exe is new version 3.0. In addition to several
  133. new help messages and small improvements to the internal code, this version 
  134. has two significant changes from the previous version:
  135.  
  136.    1. After you query a server, the same server will be automatically
  137. re-selected after a few seconds. In the previous versions of the program
  138. you had to manually re-select the server after each query.
  139.  
  140.    2. This version supports queries using the Network Time Protocol (NTP)
  141. using udp/ip port 123 in addition to requests in the daytime protocol
  142. which uses tcp/ip port 13. The daytime protocol was the only format
  143. supported in previous versions. The choice between the protocols is
  144. implemented by adding check boxes to the File | Select Server menu.
  145. The communication format can be different for each server. Your
  146. choices are stored in the configuration file, and will be "remembered"
  147. when you re-start the program if you save the configuration file.
  148.  
  149.   The choice between the two formats depends to some extent on your
  150. network connection. The NTP format measures the round-trip network delay
  151. on each cycle and is therefore potentially more accurate. However, this
  152. potential is often not realized because of jitter in the network delay
  153. and because of the poor quality of most computer clocks.
  154.  
  155. ------------------------------
  156. nistime-32bit.exe version 2.6
  157.  
  158.     The file nistime-32bit.exe is new version 2.6. This version fixes
  159. a problem with daylight saving time. The problem is only seen by a
  160. user who is in a zone that normally has daylight saving time, but disables 
  161. the automatic correction for it. The intention is to run on standard time
  162. all year, but the Windows registry does not accurately reflect this in
  163. all situations. This is not a problem with Win NT or for users who use
  164. the default setting for daylight saving time in their local time zone.
  165.  
  166. ----------------------------
  167.  
  168.     Changes in version 2.5.  In addition to a number of 
  169. minor changes, this version contains two major improvements:
  170.  
  171.    1. Handling of the conversion from UTC to local time in non-US time zones. 
  172. The improvement will be especially noticed by users in the Southern Hemisphere, 
  173. especially those in New Zealand. The difference between local time and UTC is 
  174. now read directly from the registry entry.  The transition dates to and from 
  175. daylight saving time can also be displayed using the daylight saving time menu 
  176. option. Changes to the registry time zone setting (made using the control
  177. panel Date/Time function, for example), should now be detected without 
  178. requiring a re-boot of the system, although it may still be necessary to stop
  179. and re-start the program itself.
  180.  
  181.    The direct connection between the program and the registry settings means
  182. that you cannot easily use the program if the registry setting for your location
  183. does not correctly indicate the offset between your local time and UTC or if the 
  184. transition dates to and from daylight saving time stored there are wrong. A 
  185. program called "tzedit" (usually part of the Windows distribution) can be used 
  186. to fix these problems, or you can edit the registry directly. Be warned that 
  187. direct editing of the registry can get you into real trouble and is not for the 
  188. faint of heart.
  189.  
  190.    2. If periodic queries are enabled, the program will dynamically estimate 
  191. the frequency offset of the local clock and will make small adjustments between 
  192. calibration cycles to correct for this frequency offset. This should improve the 
  193. accuracy of the local clock when using the same interval between calibrations or 
  194. should make it possible to realize the same level of accuracy with less frequent
  195. calibrations. (This capability is not supported by all versions of Windows. It
  196. will work on Windows NT, but generally does not work under Windows 9x.)
  197.  
  198.    The frequency of the clock oscillator in most computers is quite sensitive
  199. to temperature, and any algorithm that attempts to correct for variations in
  200. this frequency will be limited by the effects of changes in the ambient 
  201. temperature on the frequency of the oscillator. The capability to make small
  202. adjustments between calibration cycles therefore may not work as well as you
  203. would think.
  204.  
  205.    If you choose periodic queries, there is generally an optimum interval between
  206. queries which you will have to determine experimentally. Choosing an interval
  207. that is too small will not do any harm, but will use computer resources and
  208. network bandwidth without improving the accuracy of your clock because the
  209. internal frequency estimator would have done just as well on its own. Choosing an
  210. interval that is too large will degrade the accuracy of your clock because the
  211. fluctuations in the ambient temperature will defeat the frequency estimator.
  212. If you are interested in exploring this question, you should enable the option
  213. to write the time differences to a file, and you should examine this data
  214. as you vary the interval between calibrations.
  215.  
  216.   These changes are not incorporated into the 16-bit version of the program,
  217. which is intended for Win 3.x and 95.
  218.  
  219.    That version supports direct setting of the time zone, so that improvement 1
  220. is not needed. In addition, Windows 3.x and 9x do not support slewing the clock 
  221. frequency so that improvement 2 would not work in those environments anyway.
  222.  
  223.  
  224. Please direct questions or comments to:
  225.  
  226.     time@time.nist.gov
  227.  
  228. 4 October 2002
  229.