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 / nistimew.doc < prev    next >
Text File  |  2001-02-23  |  10KB  |  214 lines
  1. Programs NISTIMEW and NISTIME-32bit
  2.  
  3.      These programs will connect to one of the time servers operated by the
  4. National Institute of Standards and Technology (NIST), and will compare the
  5. time of the clock in your computer with the atomic time-scale operated by
  6. NIST.  The program will display the time difference and will offer you the
  7. option of adjusting your clock by the displayed amount.
  8.  
  9.      Both of these programs are designed to run in a Windows environment.  
  10. Program NISTIMEW is a 16-bit version that is suitable for Windows 3.1 or 
  11. Windows 95/98 (see additional comments below).  Program NISTIME-32bit is a 
  12. 32-bit version of the same program that is primarily intended for Windows NT
  13. or Windows 95/98/2000/Me.  All of the versions are likely to run in any 
  14. version of Windows, but there may be some problems if the 32-bit version is 
  15. run in Windows 3.1 (even if Win32S is installed) and the 16-bit version cannot
  16. set the clock on a Windows NT system (even if it is run with system
  17. privileges). In addition, the 16-bit version may not run in some versions
  18. of Win 9x because the network interface supports only 32-bit applications.
  19.  
  20.      We would recommend using the 16-bit version in Windows 3.1 and some early
  21. versions of Win 9x. It is smaller than the 32-bit version, and this advantage 
  22. is likely to be most important on smaller systems.  It offers most of the
  23. the same capabilities as the 32-bit program. Change to the 32-bit program 
  24. if you get network errors when using the 16-bit program in a Win 9x environment.
  25. (The errors may be "protocol not supported" or "invalid parameter in
  26. network call"). Use the 32-bit program for most later versions of Win 98, 
  27. and for Win 2000 and Me.
  28.  
  29.     The programs are compiled with a default list of server names and ip
  30. addresses.  You may update this list at any time using the menu option
  31.  
  32.     File | Update server list
  33.  
  34. This will copy the file nist-srv.lst from the NIST archive to your system.
  35. The file will be stored in the system directory (usually c:\windows or
  36. c:\winnt). This file contains a list of all of the time servers operated
  37. by NIST.  It is a simple text file which you may examine or print using
  38. the standard utilities. The program checks for the existence of this
  39. file each time it starts, and uses the contents to set the server menu
  40. options. You may edit this file provided you preserve its format; the
  41. program will probably malfunction if you change the format of the
  42. entries. See the comments in the file for more information.
  43.  
  44.    You can also use this file to support communicating with our systems
  45. through a proxy server. See README.PROXY in this directory for more
  46. information about doing this.
  47.  
  48.    1.  NISTIMEW
  49.  
  50.      You can configure the program to run in any time zone and with or
  51. without the adjustment for daylight saving time enabled.  These parameters
  52. will be set automatically from your user environment as defined by the
  53. control-panel settings, and you should check to be sure that these are
  54. correct before starting the program. In Windows 95/98, for example, you can 
  55. examine or change these settings using 
  56.  
  57.     Start | Settings | Control Panel | Date/Time | Time Zone
  58.  
  59. They can also be configured from inside the program using the menus; changing 
  60. either the time zone or the daylight saving time flag using the menus will 
  61. override the values defined by the system environment, but this is not 
  62. recommended under normal circumstances -- the change is only local to the 
  63. program and will not be propagated to the rest of the system.  
  64.  
  65.      The program is designed to run on any configuration that supports
  66. Windows (v3.1 or later) and using a network interface that is compatible with
  67. the Winsock standard (v1.1 or later).  It will probably run in any 32-bit
  68. environment but will be unable to set the clock on a Windows NT system.
  69. However, it is not compatible with the network interface supplied with
  70. most versions of Windows after Win 98.
  71.  
  72.     If you are using MSDOS or Windows 3.1, and if you have software that runs 
  73. in this environment and which depends on the definition of the local time zone,
  74. then it may be useful to define the environment variable TZ if you have 
  75. not already done so.  This will provide a system-wide definition of the time-
  76. zone and whether or not your system should be adjusted for daylight saving
  77. time if necessary.  The syntax of the definition statement is:
  78.  
  79.     SET TZ= XXXyZZZ
  80.  
  81. where:
  82.  
  83.     XXX is the 3-character name of your time zone: EST for Eastern
  84.     Standard Time, etc.  
  85.  
  86.     y is the offset of your standard time from UTC (Greenwich Time) in 
  87.     hours, measured West from Greenwich. This value can have a negative
  88.     sign if necessary but will be positive for all US locations.
  89.  
  90.     ZZZ is the 3-character name of your daylight time if you observe
  91.     daylight saving time; otherwise it is blank.
  92.  
  93.     Thus:
  94.  
  95.     SET TZ = EST5EDT        Eastern Time, daylight saving on
  96.     SET TZ = CST6            Central time, daylight saving off
  97.     SET TZ = MST7MDT        Mountain time, daylight saving on
  98.  
  99.     etc.
  100.  
  101.     You can add this statement to your AUTOEXEC.BAT file so that TZ is defined 
  102. automatically when your system starts. This procedure is not necessary
  103. for Windows 95 or Windows NT since these system provide the same adjustment
  104. from the control panel.  They are also optional for Windows 3.1 -- the
  105. same functionality can be achieved using the menu selections inside of
  106. the program.
  107.  
  108.     Note that turning daylight saving time on simply enables the correction 
  109. for the Summer months -- it is never applied during the Winter months no 
  110. matter how you set this switch.  The boundaries between Summer and Winter are 
  111. based on the US transitions dates of the first Sunday in April and the last 
  112. one in October.
  113.  
  114.  
  115.     2.  NISTIME-32bit
  116.  
  117.     This program reads both the time zone offset and the daylight saving time 
  118. flag from the system, and these choices cannot be changed by the program. 
  119. Apart from this difference, the two versions are almost the same from the 
  120. user point of view.
  121.  
  122.      Since this version gets the time zone offset and the daylight saving 
  123. time flag from the system, it is important that these parameters be set
  124. correctly.  You can set or check these settings using
  125.  
  126.     Start | Settings | Control Panel | Date/Time | Time Zone
  127.  
  128. and you should be sure that these settings are correct before you run
  129. the program.
  130.  
  131.      Although this program will probably run in a 16-bit Windows environment 
  132. if win32s is installed, it may not work properly in that environment.  
  133. Among other difficulties, the program may not be able to determine the local
  134. time zone offset and may do erratic things as a result.  
  135.  
  136.      Using either version, the overall uncertainty in the time comparison 
  137. should be no worse than +/- 0.5 seconds under all circumstances, and will be 
  138. substantially less than this value in most cases.
  139.  
  140. Installation of either version
  141.  
  142.      The program files are named nistimew.exe and nistime-32bit.exe.  These 
  143. are the only files that are needed initially.  Either one can be copied to 
  144. any directory on your system.  
  145.  
  146.     In Windows 3.1 You can run either version by selecting the Program Manager 
  147. command "Run ..." (on the File menu) and entering the command line:
  148.  
  149.      <path>\<program name>
  150.  
  151. where <path> is the name of the directory where you have placed the .exe file.
  152. If you have copied nistimew.exe to c:\time, for example, you would enter:
  153.  
  154.      c:\time\nistimew
  155.  
  156. You can also install an icon for this program using the "New" option on the
  157. program manager File menu.  When you select this option, complete the command
  158. line box with the path to the program file and its name.  Using the example
  159. above, you would fill in this box with the string:
  160.  
  161.      c:\time\nistimew
  162.  
  163. The other boxes are optional; you may use them to add a text string to the
  164. icon, etc.  Once you have installed the program in this way, you can run it by
  165. double-clicking on its icon in the usual way.
  166.  
  167.    In Windows 95 or Windows NT,  you can run the program using the command
  168.  
  169.     Start | Run | <path>\<program name>
  170.  
  171. where <path> and <program name> are as above. You can also run the program
  172. by double-clicking on its name in Windows explorer or by creating a short-
  173. cut to it on your desk-top.  To create the short-cut, hold down the left
  174. mouse button and drag the program from the Windows explorer display to
  175. your desktop.
  176.  
  177. If you add the word "Once" to the command line of either program (without the 
  178. quotes and using any mixture of upper- and lower-case letters), then the 
  179. program will query the NIST server once each time it is started, set your 
  180. clock (if necessary), and exit after the clock has been set.  For example,
  181. if the program is located in directory c:\time, you could use the command:
  182.  
  183.     Start | Run | c:\time\nistimew once
  184.  
  185. If you have defined a desk-top short-cut to the program, you could also 
  186. add once to the short-cut. To do this, right-click on the short-cut, open
  187. Properties | Short cut, add the word once to the target line and click OK. 
  188. This change affects the short-cut only; it will not have any effect if
  189. the program is started in some other way.
  190.  
  191.    Note that the "once" option is never added using the periodic query
  192. dialog of the program. That dialog only accepts a numerical value that sets
  193. the interval between multiple calibration cycles.
  194.  
  195.    Each time the program is started, it will use the configuration you have 
  196. saved (if this file exists) or the default configuration if no previously 
  197. saved configuration can be found.  Look at "HELP | Getting Started" for more 
  198. information.
  199.  
  200.      For additional information, please consult the various help messages.
  201.  
  202. You may address questions or comments to:
  203.  
  204. Network Time Service
  205. Time and Frequency Division
  206. National Institute of Standards and Technology
  207. 325 Broadway
  208. Boulder, Colorado 80303
  209.  
  210. e-mail: time@time.nist.gov
  211.  
  212.  
  213. Software Version: 23 February 2001
  214.