home *** CD-ROM | disk | FTP | other *** search
/ Utilities Platinum / Windows_Utilities_Platinum_Vol1.iso / desktop / settim04 / settime.doc < prev    next >
Text File  |  1993-11-11  |  5KB  |  124 lines
  1. SetTime, Version 0.4a
  2.  
  3.     Written by Tony Isaac
  4.     Completed November 11, 1993
  5.  
  6.     If you have any questions, comments, or suggestions, please send me e-mail
  7.     via the Internet (t.isaac@genie.geis.com) or GEnie (T.ISAAC).  To send
  8.     Internet mail from CompuServe, use the normal mail system and use the
  9.     address ">INTERNET:t.isaac@genie.geis.com" (minus the quotes).
  10.  
  11.     This program uses your modem to dial the NIST atomic clock in Boulder,
  12.     Colorado, and sets your PC's clock to within a second or so of the time
  13.     signal sent by that clock.
  14.  
  15.     This program was written using VisualBasic for Windows version 3.0.
  16.     While this program has been tested and is in use in real applications, it 
  17.     is NOT guaranteed to be bug-free.  If you do find a problem, please let me 
  18.     know, and I will do my best to correct the situation.  However, since this
  19.     is free, there are NO guarantees.
  20.  
  21. License
  22.     
  23.     This program is FREEWARE, and is not to be sold.  Please distribute this 
  24.     software as much as you wish, but in no case is any change to be assessed
  25.     for this software or its use.  The copyright notice in the About dialog 
  26.     box must be left intact.
  27.  
  28. Required Files
  29.  
  30.     This archive includes all the files necessary to run this program, except
  31.     for VBRUN300.DLL, which is commonly available on CompuServe, GEnie, and
  32.     other bulletin boards.  If you cannot locate this file, please contact me
  33.     by e-mail, and I will be happy to send it to you.
  34.  
  35.     Other required files that are included:
  36.  
  37.         SETTIME.EXE    Main Windows executable
  38.         KEYSTAT.VBX    Handles keystroke events
  39.         MSCOMM.VBX     Handles serial communications
  40.         THREED.VBX     Makes three-dimensional controls possible
  41.  
  42. Installation
  43.  
  44.     SETTIME.EXE may be placed wherever you wish.  The .VBX files and 
  45.     VBRUN300.DLL may be placed either in the directory with SETTIME.EXE or in 
  46.     the WINDOWS\SYSTEM directory.
  47.  
  48.     Once the files are copied to their appropriate places, run SETTIME.EXE.
  49.     A setup dialog box will appear.  Press F1 for instructions for setting
  50.     the proper values for each field.  After setting all the options 
  51.     correctly, click the Save button to save your settings in the SETTIME.INI
  52.     file, which will be created automatically the first time you run this 
  53.     program, and will be placed in your WINDOWS directory along with all the
  54.     other .INI files.  Then click the Dial button to set your computer's clock
  55.     to the NIST clock signal.
  56.     
  57. Description of SETTIME.INI
  58.  
  59. [Setup] section
  60.     Time Zones=Atlantic,Eastern,Central,Mountain,Pacific
  61.         This is a list of time zones known to this program.  If you manually
  62.         add time zones to this list, make sure you also add a corresponding 
  63.         entry to the [Time Zones] section.
  64.     Local Time Zone=Central
  65.         This should be your local time zone, but must be in the Time Zones
  66.         list above.
  67.     Serial Port=COM1
  68.         The COM port for your modem.
  69.     Baud Rates=1200,2400,4800,9600,19200,38400
  70.         This is a list of baud rates that can be selected on the setup screen.
  71.     Current Baud Rate=9600
  72.         The baud rate used to communicate with your modem.  This should be at
  73.         least 1200, and must be in the Baud Rates list above.
  74.     Modem Init String=ATE1&D2&K0
  75.         The setup string for you modem.  This should turn flow control off, 
  76.         async echo on, and set DTR to disconnect when toggled from high to low.
  77.     Dial Prefix=ATDT
  78.         The command to dial your modem.
  79.     Phone Number=1(303)494-4774
  80.         The phone number for the NIST atomic clock.
  81.     Disable DST=No
  82.         Set this to Yes ONLY if your area NEVER switches to Daylight Savings
  83.         Time.
  84.  
  85. [Time Zones] section
  86.     Atlantic=-4
  87.     Eastern=-5
  88.     Central=-6
  89.     Mountain=-7
  90.     Pacific=-8
  91.         Each time zone listed above in the [Setup] Time Zones entry should
  92.         have an entry here.  The number in each case is the number of hours
  93.         difference between the time zone and GMT.  Since this program 
  94.         automatically adjusts for Daylight Savings Time, use the offset for
  95.         standard time.
  96.  
  97. Format of Data Sent by NIST Clock
  98.  
  99.     Each second, a line with the following form is sent:
  100.         JJJJJ YY-MM-DD HH:MM:SS TT L UT1 msADV UTC(NIST) *
  101.  
  102.     JJJJJ = Julian date since 1/1/-4713 (minus 2.4 million)
  103.  
  104.     YY-MM-DD = Current date (GMT)    
  105.     
  106.     HH:MM:SS = Current time (GMT, 24-hour clock)
  107.  
  108.     TT: 00 = standard time
  109.         01-49 = daylight time, TT days until standard time
  110.         50 = daylight time
  111.         51-99 = standard time, TT days until daylight time
  112.  
  113.     L: 1 = Leap second added at midnight tonight; otherwise 0
  114.  
  115.     UT1 = Correction factor for older time measurements
  116.  
  117.     msADV = Milliseconds time code is sent in advance of actual time (allowing
  118.         for transmission delays)
  119.  
  120.     * = Time mark
  121.  
  122.     (See BYTE Magazine, October 1993, p. 60 for complete details)
  123.  
  124.