home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / time868f.zip / TIME868.HLP (.txt) < prev    next >
OS/2 Help File  |  1996-12-11  |  29KB  |  761 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. TIME868 Version 6 ΓòÉΓòÉΓòÉ
  3.  
  4. Use TIME868 to set your system clock using the Time Protocol. This protocol is 
  5. accurate to plus or minus one second. A variety of features support several 
  6. modes of operation for both permanent and dial-up access to time servers. 
  7.  
  8. TIME868 also operates as a Time Server for redistribution of accurate time to 
  9. local clients. 
  10.  
  11. TIME868 provides a graph of the adjustments made for visual reference. 
  12.  
  13. Related Information: 
  14.  
  15.      Choosing a time server 
  16.      Setting up the program 
  17.      TZ environment variable 
  18.      Dialog fields 
  19.      Providing a time server 
  20.      USNO time server 
  21.      National Institute of Standards and Technology 
  22.      About the Time Protocol 
  23.      Registering 
  24.      Change History 
  25.  
  26.  Copyright 1995,1996 Norbert Dey 
  27.  
  28.  
  29. ΓòÉΓòÉΓòÉ 2. Choosing a time server ΓòÉΓòÉΓòÉ
  30.  
  31. The basic reason for synchronizing your computer's clock is so that your value 
  32. for a particular increment of time is the same or very close to the value used 
  33. by your colleagues. 
  34.  
  35. You have two basic choices: everyone can synchronize to the same clock or 
  36. everyone can synchronize to one of several standard clocks. 
  37.  
  38. If you have no need for the exact standard value for the time, everyone simply 
  39. can synchronize to a conveniently available clock. In many applications, only a 
  40. comparison of times is necessary ... this file was created after that file ... 
  41. and so forth. As long as the clock is accurate to ordinary human standards (a 
  42. minute or so), this is sufficient. 
  43.  
  44. If it is impractical for all of your colleagues to synchronize to the same 
  45. clock, you will need to find a server which itself is traceable to a precise 
  46. standard clock. 
  47.  
  48. Some Internet service providers and larger institutions will provide time 
  49. service which is synchronized to a standard time source. If you have a local 
  50. source of accurate time, it is your best choice for a time server. 
  51.  
  52. All of the servers listed by this program are Stratum 2 or better in NTP terms. 
  53. This means that they are normally very good clocks. (Sometimes they may have 
  54. problems and drift off. A suspicious time should be checked against another 
  55. server.) 
  56.  
  57. Not all of the servers listed provide service on both TCP and UDP protocols. If 
  58. one protocol does not work, try the other. If both are provided, UDP will 
  59. generally give the best results. 
  60.  
  61. Another factor in the choice is the distance to the server in network time. A 
  62. server with a long delay will give poorer results than a server with a short 
  63. delay. Long delays are perhaps due to network congestion over that route and 
  64. therefore will be quite variable. Since the time value returned by the server 
  65. is the time at which the packet left the server, its accuracy depends on a 
  66. quick trip to your system. 
  67.  
  68. The network latency is reported in the log. This is calculated as 1/2 of the 
  69. total round trip on the assumption that the delay is symmetrical. The latency 
  70. is taken into account when computing the variance. 
  71.  
  72. A useful comparison is the difference between the latency of the selected 
  73. server and your Internet provider or gateway. I typically get 74ms latencies to 
  74. my service provider over a 28.8 modem. 
  75.  
  76. If you are operating through a firewall, your firewall system itself may be the 
  77. only outside time source, even if you have limited access to other services. 
  78.  
  79.  
  80. ΓòÉΓòÉΓòÉ 3. TZ Variable ΓòÉΓòÉΓòÉ
  81.  
  82. The TZ variable is set by a line in the config.sys file. This information 
  83. corresponds to the IBM definition for the TZ variable in OS/2. 
  84.  
  85. If you are in the continental USA, use one of these: 
  86.  
  87.      set TZ=PST8PDT 
  88.      set TZ=MST7MDT 
  89.      set TZ=CST6CDT 
  90.      set TZ=EST5EDT 
  91.      set TZ=AST4ADT 
  92.  
  93.  Some other countries for examples: 
  94.  
  95.      Israel: set TZ=IST-2IDT,4,3,6,3600,10,1,6,7200,3600 
  96.      Italy: set TZ=CET-1CDT,3,-1,0,7200,10,-1,0,10800,3600 
  97.      Newfoundland: set TZ=NST3:30NDT 
  98.      New Zealand: set TZ=NZS12NZD,9,4,0,3600,3,4,0,7600,3600 
  99.      Peru: set TZ=EST5EST,1,0,0,3600,2,0,0,3600,0 
  100.      Singapore: set TZ=SST-8SST,1,1,1,0,1,1,1,0,0 
  101.  
  102.  Some countries and parts of the USA do not change time during the summer. For 
  103.  these, use the following form: 
  104.  
  105.  set TZ=AAAOAAA,1,1,1,0,1,1,1,0,0 
  106.  
  107.  where AAA is the name of the time zone (MST for Mountain Standard Time, CST 
  108.  for Central Standard Time, SST for Singapore Standard Time) and O is the 
  109.  offset from UTC/GMT. 
  110.  
  111.  Otherwise you can construct your own TZ variable from the following 
  112.  information. The string is composed of 10 parameters, separated by commas. The 
  113.  first parameter is SSSnDDD where SSS is a 3-character label for standard 
  114.  (winter) time. This is usually all letters, but can contain digits and blanks 
  115.  after the first character. DDD is a corresponding label for daylight savings 
  116.  time (summer time). 
  117.  
  118.  The n between the SSS and DDD is the number of hours UTC is different from 
  119.  your local time (UTC - local time). Use +n or -n as appropriate. 
  120.  
  121.  If your local time zone is not an even number of hours from UTC, you may use 
  122.  the form [+/-]hh:mm:ss. For example, PST+8:00:00PDT. 
  123.  
  124.  The remaining parameters deal with the dates and times when the change is made 
  125.  to summer time and back to winter time. If your time changes follow the USA 
  126.  rules, then you do not need to supply the remainder of the parameters. 
  127.  Otherwise you need to supply them all. If only a portion of the additional 
  128.  parameters are supplied, the whole set will be ignored and they will appear to 
  129.  be totally ineffective. 
  130.  
  131.  Parameters 2-5 describe the start of summer time. 
  132.  
  133.  Parameter 2 The starting month of summer time (1-12). 
  134.  
  135.  Parameter 3 The starting week of summer time according to the following list: 
  136.  
  137.      1 - the first week of the month 
  138.      2 - the second week of the month 
  139.      3 - the third week of the month 
  140.      4 - the fourth week of the month 
  141.      0 - the change occurs on a specific day of the month 
  142.      -1 - the last week of the month 
  143.      -2 - the next to last week of the month 
  144.      -3 - the second to last week of the month 
  145.      -4 - the third to last week of the month 
  146.  
  147.  Parameter 4 The starting day of summer time. The day of the month (1-31) if 
  148.  parameter 3 was 0, otherwise the day of the week (0-6). 
  149.  
  150.  Parameter 5 The starting time-of-day (local time) in seconds. (3600 seconds is 
  151.  1AM.) 
  152.  
  153.  Parameters 6-9 describe the end of summer time. 
  154.  
  155.  Parameter 6 The starting month of winter time. 
  156.  
  157.  Parameter 7 The starting week of winter time (coded like parameter 3.) 
  158.  
  159.  Parameter 8 The starting day of winter time. The day of the month (1-31) if 
  160.  parameter 7 was 0, otherwise the day of the week (0-6). 
  161.  
  162.  Parameter 9 The starting time-of-day (local summer time) in seconds. (7200 
  163.  seconds is 2AM.) 
  164.  
  165.  Parameter 10 The final parameter specifies the amount of time shift in seconds 
  166.  (3600 = 1 hour.) 
  167.  
  168.  For example, I could use: 
  169.  
  170.            set TZ=PST+8PDT,4,1,0,3600,10,-1,0,7200,3600 
  171.  
  172.  In ordinary language, this reads as: Winter time is called 'PST' and summer 
  173.  time is called 'PDT'. I am 8 hours West of the zero meridian. Summer time 
  174.  starts on the first Sunday of April at 0100 local time. Summer time ends on 
  175.  the last Sunday of October at 0200 local time. When summer time is in effect, 
  176.  one hour (3600 seconds) is added to local time. 
  177.  
  178.  Note: EMX-based programs have a different format for the TZ variable. If you 
  179.  use EMX programs, you can set that variable with the name EMXTZ. If the 
  180.  variable EMXTZ is available, the EMX programs will use it in preference to the 
  181.  TZ variable. 
  182.  
  183.  
  184. ΓòÉΓòÉΓòÉ 4. Dialog fields ΓòÉΓòÉΓòÉ
  185.  
  186. The following panels describe the dialog fields. 
  187.  
  188.  Site      selection 
  189.  Hostname  of reference server 
  190.  IP        address of server 
  191.  TCP       Protocol support 
  192.  UDP       Protocol support 
  193.  Log       text window 
  194.  Graph     of history 
  195.  Delay     for Auto-run 
  196.  Interval  between samples 
  197.  Run       button 
  198.  Help      button 
  199.  Auto-run  feature 
  200.  Continuous running 
  201.  TZ        environment variable 
  202.  Current site Change the name 
  203.  Retry count 
  204.  Log       activity to a file 
  205.  Log file  name 
  206.  Server enable for UDP 
  207.  Log Clients by IP (and name) 
  208.  Start Minimized 
  209.  Persistent retry 
  210.  Limit maximum adjustment 
  211.  
  212.  
  213. ΓòÉΓòÉΓòÉ 4.1. Well-known sites ΓòÉΓòÉΓòÉ
  214.  
  215. This list contains several well-known sites providing time service plus two 
  216. customizable entries. You are not limited to these sites. Any of the entries 
  217. may be changed to suit your local conditions. 
  218.  
  219. The list of sites is abstracted from 
  220. http://www.eecis.udel.edu/~mills/ntp/clock2.html 
  221.  
  222. The sites selected for inclusion here are all Stratum 2 (not Stratum 1) and are 
  223. listed as open access. If you would like to use one of these sites on a regular 
  224. basis, it would be gracious of you to download the clock.txt file for the 
  225. latest status and to observe also the access policy listed. 
  226.  
  227. In most cases, your local network or your service provider will already have a 
  228. sufficiently accurate clock for regular use. 
  229.  
  230.  
  231. ΓòÉΓòÉΓòÉ 4.2. Hostname ΓòÉΓòÉΓòÉ
  232.  
  233. Enter the hostname here. Use the full name, such as tick.usno.navy.mil. If the 
  234. IP address is specified, then this field need not be used. 
  235.  
  236.  
  237. ΓòÉΓòÉΓòÉ 4.3. IP address ΓòÉΓòÉΓòÉ
  238.  
  239. If the IP address is known, enter it here. If there are any characters in this 
  240. field, the program will try to use this as an IP address. 
  241.  
  242. If you don't know (or are unsure of) the IP address, just leave it blank and 
  243. the program will consult the nameserver. The IP address found will be stored 
  244. for the next use. 
  245.  
  246. If the IP address for a server changes, simply delete the old IP address and 
  247. the program will consult the nameserver for the new IP address. 
  248.  
  249.  
  250. ΓòÉΓòÉΓòÉ 4.4. TCP radio button ΓòÉΓòÉΓòÉ
  251.  
  252. If the site provides the Time service via TCP, check this button. If you are 
  253. uncertain, just give it a try. If the service is not provided, the request will 
  254. time out in a few seconds. 
  255.  
  256.  
  257. ΓòÉΓòÉΓòÉ 4.5. UDP radio button ΓòÉΓòÉΓòÉ
  258.  
  259. If the site provides the Time service via UDP, check this button. If you are 
  260. uncertain, just give it a try. If the service is not provided, the request will 
  261. time out in a few seconds. 
  262.  
  263. If both TCP and UDP are available, UDP may give slightly better results due to 
  264. the simpler operation. 
  265.  
  266.  
  267. ΓòÉΓòÉΓòÉ 4.6. Log ΓòÉΓòÉΓòÉ
  268.  
  269. The log is a record of the actions taken when processing a request for the 
  270. time. It also records any errors encountered. 
  271.  
  272. The window will store about 2,000 characters of history. If more is needed, you 
  273. may need to log to a file. 
  274.  
  275.  
  276. ΓòÉΓòÉΓòÉ 4.7. Graph ΓòÉΓòÉΓòÉ
  277.  
  278. The graph records the last 20 results for this server. Each server is recorded 
  279. separately. The horizontal black line is the local notion of UTC. The green 
  280. band across the center of the graph indicates the span of plus and minus 1 
  281. second from local UTC. 
  282.  
  283. The horizontal scale is the time from the first of the 20 samples to the last. 
  284. Samples taken closely together in time will appear close together on the graph. 
  285.  
  286. The blue line indicates the amount of adjustment necessary to the local clock. 
  287. A value above the center line indicates that the local clock was ahead, while 
  288. below indicates the clock was behind. 
  289.  
  290. If everything is working well, the blue line will stay within the green band 
  291. once the initial correction is made. If the blue line is consistantly above the 
  292. green band, then your clock is running fast. If it is consistently below the 
  293. green band, then it is running slow. 
  294.  
  295. The red line above the center line is the latency of the time request. This is 
  296. one-half the total time for the request. It should normally be in the green 
  297. band unless the network is very busy or the time server was swapped out on the 
  298. server machine. 
  299.  
  300.  
  301. ΓòÉΓòÉΓòÉ 4.8. Delay ΓòÉΓòÉΓòÉ
  302.  
  303. When Auto-run is selected, the program will wait this number of seconds before 
  304. taking the sample. The minimum value is 5 seconds to allow time for the user to 
  305. cancel the Auto-run. 
  306.  
  307. The Auto-run may be cancelled by deselecting the check-box. 
  308.  
  309.  
  310. ΓòÉΓòÉΓòÉ 4.9. Interval ΓòÉΓòÉΓòÉ
  311.  
  312. When continuous run is selected, the program will check the time at this 
  313. interval. The minimum value is 1 minute. There is no value in checking more 
  314. often than once per hour. In fact, there is often little to be gained by 
  315. checking more than once per day. This minimum also prevents a bombardment of 
  316. the server with requests. 
  317.  
  318.  
  319. ΓòÉΓòÉΓòÉ 4.10. Run now ΓòÉΓòÉΓòÉ
  320.  
  321. Pressing this button will check the time immediately. 
  322.  
  323.  
  324. ΓòÉΓòÉΓòÉ 4.11. Help ΓòÉΓòÉΓòÉ
  325.  
  326. Select the above menu item Help to use the Help Index, General Help or to get 
  327. basic information on how to use Help. Select for General Help. 
  328.  
  329.  
  330. ΓòÉΓòÉΓòÉ 4.12. Auto-run ΓòÉΓòÉΓòÉ
  331.  
  332. When this is selected, the program will automatically check the time after a 
  333. short delay. If continuous running or server enable are not selected, the 
  334. program will exit. 
  335.  
  336.  
  337. ΓòÉΓòÉΓòÉ 4.13. Continuous ΓòÉΓòÉΓòÉ
  338.  
  339. When this is selected, the program will check the time each interval. 
  340.  
  341.  
  342. ΓòÉΓòÉΓòÉ 4.14. Current Site Name ΓòÉΓòÉΓòÉ
  343.  
  344. The field contains an editable copy of the currently selected site name. 
  345. Changes to the name will show in the list the next time the program is loaded. 
  346.  
  347.  
  348. ΓòÉΓòÉΓòÉ 4.15. Retry Count ΓòÉΓòÉΓòÉ
  349.  
  350. Use this field to set the number of tries before giving up. 
  351.  
  352.  
  353. ΓòÉΓòÉΓòÉ 4.16. Logging ΓòÉΓòÉΓòÉ
  354.  
  355. Check this box if you wish the activity to be logged to a file. Each time the 
  356. program runs, information is added to the file. 
  357.  
  358. Over time, the file can get quite large, so check the file size from time to 
  359. time if you are using this feature. 
  360.  
  361. The logging of server start and stop are also controlled here. 
  362.  
  363.  
  364. ΓòÉΓòÉΓòÉ 4.17. Log file name ΓòÉΓòÉΓòÉ
  365.  
  366. This field sets the file name to be used for the log file. Each site can have a 
  367. different log file. 
  368.  
  369. Server activity is logged to the current file. 
  370.  
  371.  
  372. ΓòÉΓòÉΓòÉ 4.18. Server enable ΓòÉΓòÉΓòÉ
  373.  
  374. Check this box to enable the UDP Time Server. This will enable the program to 
  375. provide time service to other systems. 
  376.  
  377. The most common use will be to have a designated system get the time from an 
  378. outside source over the Internet (or other TCP/IP) network and then 
  379. redistribute the time to clients on the local area network. 
  380.  
  381. Even in the absence of an outside reference, the systems on a local network can 
  382. be kept in close synchronization. 
  383.  
  384. When enabled, the server is started as soon as the program is started and 
  385. remains running as long as the program does. 
  386.  
  387. The selection of server enable prevents the program from automatically shutting 
  388. down after an Auto-Run. It is recommended that Auto-Run be enabled to sync the 
  389. server with the reference source on starting and that Continuous be enabled to 
  390. keep the server on time. 
  391.  
  392. Deselecting this box will stop the server within a few seconds. 
  393.  
  394.  
  395. ΓòÉΓòÉΓòÉ 4.19. Log clients ΓòÉΓòÉΓòÉ
  396.  
  397. Check this box if you need to see which clients are requesting time service. 
  398.  
  399. The IP address of the client is provided, along with the name of the client if 
  400. it is available. 
  401.  
  402. Client logging can reduce the throughput and responsiveness of the server if 
  403. there are a large number of clients. It is recommended that this feature be 
  404. used for service and then disabled when not in active use. 
  405.  
  406.  
  407. ΓòÉΓòÉΓòÉ 4.20. Start minimized. ΓòÉΓòÉΓòÉ
  408.  
  409. Check this box if you would like the program to start in a minimized state. 
  410.  
  411. You will probably check this box after you are comfortable with the reliability 
  412. and features of the program. 
  413.  
  414. While minimized, the program continues to operate normally. 
  415.  
  416. You can maximize the program by selecting it from the window list or clicking 
  417. on the icon in the Minimized Window Viewer or on the Desktop (depending on 
  418. where you minimize things.) 
  419.  
  420.  
  421. ΓòÉΓòÉΓòÉ 4.21. Persistant retry. ΓòÉΓòÉΓòÉ
  422.  
  423. When this box is checked, the program will persistently try to obtain a sample 
  424. until it is successful. 
  425.  
  426.  
  427. ΓòÉΓòÉΓòÉ 4.22. Maximum adjustment. ΓòÉΓòÉΓòÉ
  428.  
  429. This spin button selects the maximum adjustment permitted by any one sample. If 
  430. the sample suggests an adjustment larger than this value, the sample is 
  431. discarded. This will prevent the local clock from being set if the time server 
  432. suddenly becomes bad. 
  433.  
  434. The value ANY allows any adjustment. This value is suggested for initial use to 
  435. set the clock to the correct time. After the initial setting, a value of 2-4 
  436. seconds should allow normal correction, but prevent erroneous settings. 
  437.  
  438.  
  439. ΓòÉΓòÉΓòÉ 5. Other Information ΓòÉΓòÉΓòÉ
  440.  
  441.      About the Time Protocol 
  442.      USNO time server 
  443.      National Institute of Standards and Technology 
  444.      UTC 
  445.  
  446.  
  447. ΓòÉΓòÉΓòÉ 5.1. Time Protocol ΓòÉΓòÉΓòÉ
  448.  
  449.  Network Working Group 
  450.  
  451.  Request for Comments: 868 
  452.  
  453.  J. Postel - ISI 
  454.  
  455.  K. Harrenstien - SRI 
  456.  
  457.            May 1983 
  458.  
  459.  Time Protocol 
  460.  
  461.  This RFC specifies a standard for the ARPA Internet community.  Hosts on the 
  462.  ARPA Internet that choose to implement a Time Protocol are expected to adopt 
  463.  and implement this standard. 
  464.  
  465.  This protocol provides a site-independent, machine readable date and time. 
  466.  The Time service sends back to the originating source the time in seconds 
  467.  since midnight on January first 1900. 
  468.  
  469.  One motivation arises from the fact that not all systems have a date/time 
  470.  clock, and all are subject to occasional human or machine error.  The use of 
  471.  time-servers makes it possible to quickly confirm or correct a system's idea 
  472.  of the time, by making a brief poll of several independent sites on the 
  473.  network. 
  474.  
  475.  This protocol may be used either above the Transmission Control Protocol (TCP) 
  476.  or above the User Datagram Protocol (UDP). 
  477.  
  478.  When used via TCP the time service works as follows: 
  479.  
  480.    S: Listen on port 37 (45 octal). 
  481.  
  482.    U: Connect to port 37. 
  483.  
  484.    S: Send the time as a 32 bit binary number. 
  485.  
  486.    U: Receive the time. 
  487.  
  488.    U: Close the connection. 
  489.  
  490.    S: Close the connection. 
  491.  
  492.  The server listens for a connection on port 37.  When the connection is 
  493.  established, the server returns a 32-bit time value and closes the connection. 
  494.  If the server is unable to determine the time at its site, it should either 
  495.  refuse the connection or close it without sending anything. 
  496.  
  497.  When used via UDP the time service works as follows: 
  498.  
  499.    S: Listen on port 37 (45 octal). 
  500.  
  501.    U: Send an empty datagram to port 37. 
  502.  
  503.    S: Receive the empty datagram. 
  504.  
  505.    S: Send a datagram containing the time as a 32 bit binary number. 
  506.  
  507.    U: Receive the time datagram. 
  508.  
  509.  The server listens for a datagram on port 37.  When a datagram arrives, the 
  510.  server returns a datagram containing the 32-bit time value.  If the server is 
  511.  unable to determine the time at its site, it should discard the arriving 
  512.  datagram and make no reply. 
  513.  
  514.  The Time 
  515.  
  516.  The time is the number of seconds since 00:00 (midnight) 1 January 1900 UTC, 
  517.  such that the time 1 is 12:00:01 am on 1 January 1900 UTC; this base will 
  518.  serve until the year 2036. 
  519.  
  520.  For example: 
  521.  
  522.  the time  2,208,988,800 corresponds to 00:00  1 Jan 1970 UTC, 
  523.  
  524.  2,398,291,200 corresponds to 00:00  1 Jan 1976 UTC, 
  525.  
  526.  2,524,521,600 corresponds to 00:00  1 Jan 1980 UTC, 
  527.  
  528.  2,629,584,000 corresponds to 00:00  1 May 1983 UTC, 
  529.  
  530.  and -1,297,728,000 corresponds to 00:00 17 Nov 1858 UTC. 
  531.  
  532.  [As an astute reader has pointed out, this last example makes no sense at all. 
  533.  - Norbert] 
  534.  
  535.  
  536. ΓòÉΓòÉΓòÉ 5.2. U.S. Naval Observatory ΓòÉΓòÉΓòÉ
  537.  
  538. The U.S. Naval Observatory has established two new network time servers for 
  539. reliable, accurate time over the Internet and Milnet WANS: 
  540.  
  541.  tick.usno.navy.mil 192.5.41.40 
  542.  
  543.  tock.usno.navy.mil 192.5.41.41 
  544.  
  545.  These HP9000/747i systems host Datum VME synchronized generators using IRIG-b 
  546.  timecode from USNO Master Clock #2. The system clocks of these servers are 
  547.  synchronized to within a few tens of microseconds of USNO Master Clock 2. 
  548.  
  549.  UTC(USNO) is provided over the network via a number of protocols. At present, 
  550.  access is unrestricted. 
  551.  
  552.  
  553. ΓòÉΓòÉΓòÉ 5.3. National Institute of Standards and Technology ΓòÉΓòÉΓòÉ
  554.  
  555. NIST (National Institute of Standards and Technology) provides time service at 
  556. time.nist.gov (132.163.135.130). 
  557.  
  558. The NIST Network Time Server is synchronized to the NIST cesium clock ensemble. 
  559. The server transmits time using three common internet protocols:  tcp/ip, 
  560. udp/ip and NTP (Network Time Protocol). 
  561.  
  562.  
  563. ΓòÉΓòÉΓòÉ 5.4. Universal Time, Coordinated ΓòÉΓòÉΓòÉ
  564.  
  565. This is also known as GMT (Greenwich Mean Time) and Zulu (Zero) time. UTC is an 
  566. international standard for reporting time. 
  567.  
  568. The zero meridian crosses Greenwich, England, home of the Royal Observatory. 
  569.  
  570.  
  571. ΓòÉΓòÉΓòÉ 6. Time Server ΓòÉΓòÉΓòÉ
  572.  
  573. A Time Server capability is included in the program. When enabled, the program 
  574. will provide time service to other systems. 
  575.  
  576. The server also provides the ability to log the client requests, so that you 
  577. can check that your time distribution is working. 
  578.  
  579. This facility allows the clients on a LAN to stay on a common time basis even 
  580. if isolated from a precise time source. 
  581.  
  582. For testing the time server, run the ifconfig utility, setting up the loopback 
  583. interface. 
  584.  
  585. Open an OS/2 command window. Run the command: 
  586.  
  587. ifconfig lo 127.0.0.1 
  588.  
  589. Now, start TIME868. Set one of the custom entries to an IP address of 127.0.0.1 
  590. and enable the server. Set the server to log clients. Press "Run now" and you 
  591. will see the client get the time from the server. 
  592.  
  593.  
  594. ΓòÉΓòÉΓòÉ 7. Setup ΓòÉΓòÉΓòÉ
  595.  
  596. Before starting to use the program, check to see that your TZ environment 
  597. variable is set correctly for your local time zone. If you change your 
  598. config.sys file, you will need to shutdown and re-boot for the change to be 
  599. effective. 
  600.  
  601. Also check to see if your clock is somewhat close to the correct time. If your 
  602. clock is more than 4-5 minutes slow, the first correction may trick your dialer 
  603. into thinking that the idle time has exceeded its limit and disconnect you. 
  604.  
  605. If this happens, just reconnect. The first correction has already been made and 
  606. the next try will cause no problems. 
  607.  
  608. Initially set the Maximum adjustment field to ANY. Then after the clock has 
  609. been set to the correct time, change this field to 2-4 seconds. 
  610.  
  611. Choose a time server site from those listed or identify one better for you. 
  612.  
  613. The Auto-run feature was designed for those of us who are only connected to the 
  614. Internet once or twice a day. When this feature is selected, the program will 
  615. wait for the specified delay, then get the time and exit. (If you enable the 
  616. server feature, the program will not automatically exit.) 
  617.  
  618. The initial delay should be set just long enough for the initial burst of 
  619. network traffic (the newsreader starting, etc) to settle down. If TIME868 is 
  620. competing with everything else for your PPP or SLIP link, the delays may be too 
  621. long for accurate time collection. 
  622.  
  623. If you have a permanent connection to the Internet or to a time-server on a 
  624. LAN, you may wish to keep the program running and use the  Continuous running 
  625. feature to check the time periodically. Once or twice a day should be all that 
  626. is necessary. 
  627.  
  628. If you are running the server, you will want to keep the program continuously 
  629. running. 
  630.  
  631. After you are comfortable with the operation, you may wish the program to start 
  632. minimized. The program will run fine while minimized, it just won't be taking 
  633. up screen space. 
  634.  
  635. SLIP/PPP connections: Select Auto-run and Start Minimized. Then create a shadow 
  636. of TIME868 into your Startup Folder. Now, whenever you start your system, 
  637. TIME868 will automatically start running. Then, when you log into your Internet 
  638. Service Provider, TIME868 will sense the connection, set the clock, and exit. 
  639.  
  640. Alternatively, if you use a startup script with your Internet access, you can 
  641. start TIME868 with the drive and directory name where the configuration and log 
  642. files should be kept. For example: 
  643.  
  644.       TIME868 e:\web 
  645.  
  646.  
  647. ΓòÉΓòÉΓòÉ 8. Registering the program ΓòÉΓòÉΓòÉ
  648.  
  649. TIME868 is free. But a picture postcard or an email note is appreciated. (I am 
  650. putting pushpins into a large world map on the wall and surrounding it with the 
  651. postcards.) If you are using TIME868 for multiple systems, please let me know 
  652. how many. 
  653.  
  654.       Norbert Dey 
  655.       PO Box 103 
  656.       Newberg OR 97132 
  657.       USA 
  658.  
  659.  Bug reports and suggestions may be sent to dey@teleport.com 
  660.  
  661.  Thank you, Norbert Dey 
  662.  
  663.  DISCLAIMER 
  664.  
  665.  The author of this program accepts no responsibility for damages that are 
  666.  caused by this program and make NO WARRANTY or representation, either express 
  667.  or implied, with respect to this software.  This software is provided "AS IS," 
  668.  and you assume the entire risk when you use it. 
  669.  
  670.  
  671. ΓòÉΓòÉΓòÉ 9. Changes by version ΓòÉΓòÉΓòÉ
  672.  
  673.      Version 6, time868f.zip 
  674.      Version 5, time868e.zip 
  675.      Version 4, time868d.zip 
  676.      Version 3, time868c.zip 
  677.      Version 2, time868b.zip 
  678.  
  679.  
  680. ΓòÉΓòÉΓòÉ 9.1. Changes in version 2 (time868b.zip). ΓòÉΓòÉΓòÉ
  681.  
  682. Fixed minimize to desktop. (Minimize to viewer was working fine.) 
  683.  
  684. Added program to window switch list. 
  685.  
  686. Added more information about setting the TZ 
  687.  
  688. Added retry option and counter. 
  689.  
  690. The format of the configuration file has changed and been renamed to 
  691. TIME868.CFG. 
  692.  
  693. Added log file option. 
  694.  
  695. Added ability to edit name for custom sites (or the name of any site for that 
  696. matter.) 
  697.  
  698. Added Time server capabilities. 
  699.  
  700.  
  701. ΓòÉΓòÉΓòÉ 9.2. Changes in version 3 (time868c.zip). ΓòÉΓòÉΓòÉ
  702.  
  703. Under some circumstances, the icon would be lost. Under other circumstances, 
  704. the icon would appear merged with part of the screen when minimized to the 
  705. desktop. These appear to be fixed. 
  706.  
  707. Added a switch  ... -h  ... to send zero length packets as the request packet. 
  708. One implementation of the Time Protocol expects zero length. 
  709.  
  710. Increased length of hostname variable to 63 bytes. 
  711.  
  712.  
  713. ΓòÉΓòÉΓòÉ 9.3. Changes in version 4 (time868d.zip). ΓòÉΓòÉΓòÉ
  714.  
  715. Added more information to this help file. 
  716.  
  717. If TIME868 was started from the Startup Folder, it would often exit before a 
  718. SLIP/PPP connection was made. A Persisent retry option has been added so that a 
  719. valid TCP/IP connection must be made before the time sample is complete. This 
  720. means that you can now use the Startup Folder in a very natural way. 
  721.  
  722. Select Auto-run, Persistent retry and Start Minimized. 
  723.  
  724. Create a shadow of TIME868 into your Startup Folder. 
  725.  
  726. Now, whenever you start your system, TIME868 will automatically start running. 
  727. Then, when you log into your Internet Service Provider, TIME868 will sense the 
  728. connection, set the clock, and exit. 
  729.  
  730.  
  731. ΓòÉΓòÉΓòÉ 9.4. Changes in version 5 (time868e.zip). ΓòÉΓòÉΓòÉ
  732.  
  733. Fixed the server. I was in too much of a hurry. I know better. 
  734.  
  735.  
  736. ΓòÉΓòÉΓòÉ 9.5. Changes in version 6 (time868f.zip). ΓòÉΓòÉΓòÉ
  737.  
  738. Another correction for the length of the hostname (greater than 32 bytes). 
  739.  
  740. Rewrote the time setting routine to allow large variances without exceeding the 
  741. length of a signed long (2^31). 
  742.  
  743. Added a direct control on the maximum amount of variance allowed. Note that the 
  744. restriction does not apply to the first sample upon changing from Summer time 
  745. to Winter time or vice versa. 
  746.  
  747. If you start TIM868 from a script, you can now provide the drive and directory 
  748. where the configuration (TIME868.CFG) and log files are kept. For example: 
  749.  
  750.       TIME868 d:\time 
  751.  
  752.  Fixed a bug where the program would still persist in retrying even though the 
  753.  Persistent Retry feature was not enabled. This occurred when the dialup 
  754.  connection was not available. 
  755.  
  756.  Improvements to the online help. 
  757.  
  758.  
  759. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  760.  
  761. A symbol that shows that a choice is currently active.