home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / nistime2.zip / README.2 < prev   
Text File  |  2001-11-02  |  6KB  |  155 lines
  1. NISTIME for OS/2 Warp 3 and Warp 4 release notes
  2.  
  3. Version 0.2d   02-nov-2001
  4.  
  5. Pieter Bras
  6. Cambridge, MA
  7. pbras@pobox.com
  8.  
  9.  
  10. Description
  11. -----------
  12.  
  13. This program is an update of the NISTIME for OS/2 program produced
  14. by Michael Thompson in 1993 (see README), which was ported from the 
  15. Unix code written by Judah Levine at NIST.
  16.  
  17. Functional differences in the current version:
  18.  
  19. - default time server choice changed from 132.163.135.130
  20. - command-line parameter allows user to override the default server choice
  21. - command-line option for maximum network delay (default = 250 msec)
  22. - more precise time reporting and setting (+/- 0.5 second)
  23. - modified built-in help to describe above features
  24.  
  25. Also:
  26.  
  27. - included official NISTIME icon (copied from NISTIME for Windows)
  28. - REXX script to query multiple NIST servers for correct time
  29.  
  30. The time is set to within +/- 0.5 second.  This is not a limitation of
  31. the NIST protocol, which should allow for better than +/- 0.1 second
  32. accuracy, but rather is the best that can be expected using the native
  33. OS/2 API DosSetDateTime().
  34.  
  35. Usage
  36. -----
  37.  
  38. This section complements the nistime.man file which should be read first.
  39.  
  40. You can run nistime.exe by itself but it is more useful to use the REXX
  41. script nistime2.cmd in because that will try a list of servers until it gets
  42. a satisfactory response. Any given server may be unavailable or "unhealthy"
  43. or overloaded from time to time.  Note that a NIST time server will give a
  44. "connection refused" response if its load approaches 1500 requests/second.
  45.  
  46. The file my-nist-srv.lst has the time servers ordered by distance from
  47. Boston, MA.  You can rearrange the order of the servers to suit your own
  48. geographical location but be sure to preserve the format of the file.
  49.  
  50. The lower the round-trip network delay, the less resulting error in the time
  51. calculation.  One way to determine which servers respond best to your location
  52. is to run the command "nistime2 -m2 -d1" and observe the round-trip times
  53. from the various servers.  None of them will be able to respond within one
  54. millisecond so the program will try all the listed servers.  You may need
  55. to redirect the output to a log file to be able to compare the times better.
  56. Note that you will need to redirect both sdtout and stderr, as follows:
  57.  
  58. nistime2 -m2 -d1 my-nist-srv.lst >logfile 2>&1
  59.  
  60. The default round-trip delay limit of 250 milliseconds should be enough for
  61. users within the USA. For instance I typically get round-trip times of 40-50
  62. milliseconds from the nist1-ny.glassey.com (Boston-New York-Boston).  If you
  63. have a particularly slow link then you may need to override the default delay
  64. using the -d option.
  65.  
  66. Note that NISTIME will work properly only with NIST time servers.  Other
  67. time servers that provide a "daytime" service (RFC 867) will use message
  68. formats that are incompatible with NISTIME.
  69.  
  70. Nistime2.cmd can be invoked from within another script such as startup.cmd.
  71.  
  72.  
  73. Further Information
  74. -------------------
  75.  
  76. Some currently available NIST time servers are found listed in the
  77. included file nist-srv.lst which is occasionally updated and can be
  78. downloaded from any NIST ftp server.  Also:
  79.  
  80. 132.163.135.130 (old NISTIME default)
  81. time_a.timefreq.bldrdoc.gov
  82. time_b.timefreq.bldrdoc.gov
  83. time_c.timefreq.bldrdoc.gov
  84.  
  85. An html list of NIST time servers can be found at:
  86. http://www.boulder.nist.gov/timefreq/service/time-servers.html
  87.  
  88. Further information can be found at:
  89. http://www.boulder.nist.gov/timefreq/service/its.htm
  90.  
  91.  
  92. Compatibility
  93. -------------
  94.  
  95. The current version is backward compatible with the original version of
  96. NISTIME for OS/2 (from 1993). The time offset is now reported to the nearest
  97. hundredth of a second (for example, -0.25).
  98.  
  99. This program has been tested on the following OS/2 configurations:
  100.  
  101. OS/2 Warp 3 Connect (FP 40) with TCP/IP stack 4.02y
  102. OS/2 Warp 4 (FP 10) with TCP/IP 4.1 (updated with WR8620/UN_2001)
  103. OS/2 Warp 4.5 (MCP) with TCP/IP 4.3 (updated with IC27649)
  104.  
  105. No guarantees are made about compatibility with any other OS/2
  106. configurations.  Program is provided "as is" and the author disavows
  107. responsibility for compatibility problems or any other difficulties
  108. that may arise from its use.
  109.  
  110.  
  111. Developer details
  112. -----------------
  113.  
  114. IBM C Set++ 2.01 for OS/2, updated with fixpacks CTM0010,CTC0012,CTU0003
  115. IBM Developer's Toolkit for OS/2 Warp Version 3 (from DevCon 12)
  116. IBM TCP/IP Version 3.0 for OS/2 Programmer's Toolkit (from DevCon 12)
  117. OS/2 Link386 3.00.002
  118.  
  119. New Files:
  120.  
  121. nistime.c       -- updated source
  122. nistime.exe     -- new executable
  123. cl.cmd          -- compile/link commands used to generate new executable
  124. nistime.ico     -- official NISTIME icon (copied from NISTIME for Windows)
  125. nistime.man     -- includes description of new/modified features
  126. README.2        -- this file
  127. nist-srv.lst    -- official list of NIST time servers
  128. my-nist-srv.lst -- above list distance-optimized for Boston, MA 
  129. nistime2.cmd    -- REXX script to query a list of NIST time servers
  130.  
  131.  
  132. Revision History
  133. ----------------
  134.  
  135. Ver 0.2d (02-nov-2001):
  136.  - improved error checking and better error messages
  137.  - changed default NIST time server again
  138.  
  139. Ver 0.2c (09-jun-2001):
  140.  - use msADV value in NIST message to reduce clock error
  141.  - measure round-trip network delay to reduce clock error
  142.  - measured clock offset reported to nearest .01 sec 
  143.  - return codes changed to uniquely identify various error conditions
  144.  - command-line parameter for maximum network delay (default = 250 msec)
  145.  - output time server host ID only if -m2 option is selected
  146.  
  147. Ver 0.2b (14-may-2001):
  148. - suppress output of time server host ID if -m0 option is selected
  149.  
  150. Ver 0.2 (13-may-2001):
  151. - default time server choice changed from 132.163.135.130 to time.nist.gov
  152. - command-line parameter allows user to override the default server choice
  153. - modified built-in help to describe above features
  154.  
  155.