home *** CD-ROM | disk | FTP | other *** search
/ Netware Super Library / Netware Super Library.iso / timevent / time_svr / tserve.doc < prev    next >
Encoding:
Text File  |  1995-04-06  |  39.7 KB  |  890 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                    * * * * * * * * * * * * * * * * * * * * * * *
  14.                    * * * * * * * * * * * * * * * * * * * * * * *
  15.                    * *                                       * *
  16.                    * *         T I M E   S E R V E R         * *
  17.                    * *                                       * *
  18.                    * *      Keeps Your Network On Time       * *
  19.                    * *                                       * *
  20.                    * * * * * * * * * * * * * * * * * * * * * * *
  21.                    * * * * * * * * * * * * * * * * * * * * * * *
  22.  
  23.  
  24.  
  25.                                    version 2.2
  26.  
  27.  
  28.  
  29.  
  30.  
  31.                          (c) Copyright Jiri Severa, 1994
  32.  
  33.  
  34.  
  35.       TSERVE USER GUIDE                                               1
  36.       -----------------------------------------------------------------
  37.  
  38.  
  39.       COPYRIGHT NOTICE
  40.  
  41.       The software found in the archive file along with this document
  42.       is the property of Jiri Severa of Ottawa, Ontario, Canada. Any
  43.       use, reproduction and/or distribution of this software on terms
  44.       other than those expressly stated in the SHAREWAR.E document
  45.       enclosed is prohibited.
  46.  
  47.  
  48.       ABOUT TSERVE
  49.  
  50.       The single purpose of this software collection is to provide the
  51.       means of setting and maintaining a reliable time standard on a single
  52.       Intel processor-based PC or on a Novell network. Simply put, the progr-
  53.       ams connect a user's machine to a very accurate clock via modem and
  54.       synchronize the PC's internal clock with an international standard. The
  55.       process is repeated at intervals of the user's choosing. On a network,
  56.       the machine selected to import the exact time becomes a time server:
  57.       primary source from which the whole network synchronizes the clocks
  58.       of its local servers.
  59.  
  60.             What is the benefit of a time server ? The answer to that is
  61.       that there are a number of benefits:
  62.  
  63.            * authoritative time reference - human inquiry : someone mentioned
  64.              to me the other day that since we installed a time server on our
  65.              network 'my Windows clock actually tells time'. An accurate time
  66.              source and a means to broadcast it is something that adds to any
  67.              organization's productive assets.
  68.  
  69.            * event tracking - a number of network processes are logged and the
  70.              logs are later analyzed to evaluate specific functions. More often
  71.              then not the entries' date stamps are of crucial importance, rel-
  72.              ating to other, external, events in real time. When an unattended
  73.              server goes down you would want to know when exactly it happened.
  74.  
  75.            * software alarms - a popular feature with a number of Office-type
  76.              software schedulers are warning bells that ring an x-number of
  77.              minutes before meetings, departures, etc. These programs, not to
  78.              say their users, assume that the workstation keeps accurate time.
  79.  
  80.            * e-mail handling - the performance of e-mail facilities is often
  81.              subject of queries, and there the needs of a modern, distributed
  82.              data-handling come into a relief. Today, hundreds of thousands of
  83.              messages will be exchanged among the world's e-mail users on which
  84.              the date stamp of the reply will precede that of the original mess
  85.              age. No great harm done, but under these conditions it becomes
  86.              difficult to follow the traffic on an e-mail net and gauge the
  87.              throughput at different transfer points by simply comparing time
  88.              stamps.
  89.  
  90.       These are but a few examples but the trend to distributed, client-server
  91.       data processing will soon force time synchronization as a matter of
  92.       course.
  93.  
  94.  
  95.       TSERVE USER GUIDE                                               2
  96.       -----------------------------------------------------------------
  97.  
  98.             The solution to getting oneself on a standard time would have
  99.       been in the most recent past to buy some pretty fancy and
  100.       expensive gear to get in sync with the nearest cesium atomic
  101.       clock. That is the expensive solution and a massive overkill because
  102.       the precision of a few nanoseconds is mostly lost on systems whose
  103.       internal oscillator registers ticks once every 55 milliseconds. So,
  104.       apparently a connection to a 300 baud transmitter which provides
  105.       the public with the precision time reading will do under such circum-
  106.       stances. This is what TSERVE does.
  107.  
  108.  
  109.  
  110.       ABOUT THE NATIONAL RESEARCH COUNCIL'S (CANADA) TIME SERVICE
  111.  
  112.       The provider for TSERVE time standard is the Institute for National
  113.       Measurement Standards, a branch of Canada's National Research
  114.       Council. The time services run by the Institute are available
  115.       to the general public and include voice service, telephone digital
  116.       code time signals, short wave transmission and remote calibration.
  117.       You may write for more information on those services to :
  118.  
  119.                    National Resarch Council
  120.                    Institute for National
  121.                    Measurement Standards
  122.                    (Time Services)
  123.  
  124.                    Ottawa, Canada
  125.                    K1A OR6
  126.  
  127.       Needless to say, this software would not be possible without a
  128.       public service which makes time standard available at low-cost,
  129.       actually, at this time , at no cost other than the telephone
  130.       call. Naturally then, this shareware becomes also a sort of a
  131.       crusade to assure that this service does not go on the chopping
  132.       block, and that the facilities are upgraded to answer the demand.
  133.       Please, take time to fill in the Request for Continuous Time
  134.       Service in the CRUSADE.NRC file and send it together with your
  135.       registration fee. This request is of course valid only in case
  136.       you are a Canadian resident. For U.S. citizens, we would be grate-
  137.       ful if you send the requested $20 (US) NRC contribution as a goodwill
  138.       gesture.
  139.  
  140.  
  141.  
  142.       TSERVE USER GUIDE                                               3
  143.       -----------------------------------------------------------------
  144.  
  145.  
  146.       THE ARCHIVE FILES
  147.  
  148.       The shareware package contains the following files :
  149.  
  150.       SHAREWAR.E  - spells out the terms and conditions under which
  151.                     you may use this software.
  152.  
  153.       CRUSADE.NRC - form letter to the National Research Council
  154.                     requesting the continuance of service.
  155.  
  156.       TSERVE.DOC  - user manual
  157.       TSERVE.EXE  - time server communication program
  158.                     synchronization
  159.  
  160.       NSSFX.EXE   - Netware Sync Single File Server module
  161.       NSMFX.EXE   - Netware Sync Multiple File Server module - up to eight.
  162.  
  163.       DAYLIGHT.EXE - Standard-Daylight, Daylight-Standard switch module
  164.       STIME.EXE    - Server time update utility for Netware workstations
  165.  
  166.       GENIE.EXE    - Batch Scheduler / Processor
  167.       SETGENIE.EXE - Setup Utility for GENIE
  168.       BTRACK.EXE   - Batch tracking utility
  169.  
  170.       GENIE.DOC    - GENIE user guide
  171.  
  172.  
  173.  
  174.       HARDWARE AND SOFTWARE REQUIREMENTS
  175.  
  176.       Intel 8088 based PC or better.
  177.       Hayes-compatible 1200 baud modem.
  178.       MS DOS ver. 3.3 +
  179.  
  180.  
  181.  
  182.       TSERVE USER GUIDE                                               4
  183.       -----------------------------------------------------------------
  184.  
  185.  
  186.  
  187.       INSTALLATION AND OPERATION OF TSERVE
  188.  
  189.             To install the time server software simply copy the files
  190.       to a directory on your hard disk or even to a diskette. You may
  191.       run TSERVE from a diskette and on a plain old XT with no loss of
  192.       time-keeping precision.
  193.             To run a timesync session enter the following command at a
  194.       DOS prompt in the directory where you installed the software, e.g.:
  195.  
  196.                    C:\TSRV>TSERVE  <Enter>
  197.  
  198.       After TSERVE has been started you don't need to do anything to aid
  199.       the program to communicate with the time provider. The program has
  200.       been designed as a fully automated process requiring no manual
  201.       intervention. After a short pause at the beginning of the program,
  202.       about which more shortly the following two display windows appear
  203.       on the screen:
  204.  
  205.      ╔══════════════════════════════════════════════════════════════╗
  206.      ║                                                              ║
  207.      ║             NRC Atomic Clock Time Synchronization            ║
  208.      ║                                                              ║
  209.      ║ Time Zone :                                                  ║
  210.      ║ Start Time  :                          Date :                ║
  211.      ║ Equip. Bias :                   Clock Ticks :                ║
  212.      ║ Loop Delay  :                   Sync at :                    ║
  213.      ║                                                              ║
  214.      ╚══════════════════════════════════════════════════════════════╝
  215.  
  216.      ╔══════════════════════════════════════════════════════════════╗
  217.      ║                                                              ║
  218.      ║                                                              ║
  219.      ║                                                   ...wait  ! ║
  220.      ╚══════════════════════════════════════════════════════════════╝
  221.  
  222.       The upper window reports on the time-keeping parameters during
  223.       the ongoing dialog. Their meaning is explained below in 'SETTING
  224.       SESSION PARAMETERS'. The lower box reports session status,
  225.       dutifully reporting on what the program is up to at all times.
  226.       See below TROUBLESHOOTING AND TSERVE MESSAGES for clues.
  227.       The upper display stays on for several seconds after the end
  228.       of the session.
  229.           Starting with version 2.0 it is possible to cancel the call
  230.       to NRC at any time during modem initialization or dialup.
  231.  
  232.  
  233.  
  234.  
  235.       TSERVE USER GUIDE                                               5
  236.       -----------------------------------------------------------------
  237.  
  238.       SETTING SESSION PARAMETERS
  239.  
  240.           At the start the program loops for 5 seconds displaying
  241.       the maple leaf logo. During this time the user has the option
  242.       to reset session parameters. Hit any key.
  243.  
  244.       The following panel will appear :
  245.  
  246.                                                                    │
  247.                          ┌───────┬───────┐                         ││
  248.         Communication :  > COM1: < COM2: │         Time Zones :    ││
  249.                          └───────┴───────┘                         ││
  250.           ┌──────speed─┐ ┌data┐ ┌stop┐ ┌parity┐  ┌──────────────┐  ││
  251.           >   300 baud < >  8 < >  1 < > none <  │ Newfoundland │  ││
  252.           │  1200 baud │ │  7 │ │  2 │ │  odd │  │   Atlantic   │  ││
  253.           │  2400 baud │ │  9 │ │  0 │ │ even │  >   Eastern    <  ││
  254.           │  9600 baud │ └────┘ └────┘ └──────┘  │   Central    │  ││
  255.           │ 14400 baud │  speaker Netware Sync   │   Mountain   │  ││
  256.           └────────────┘  > on  < │  enable  │   │   Pacific    │  ││
  257.          bias   0/100 sec │ off │ > disable  <   │  GMT offset  │  ││
  258.          clck  .05495 sec └─────┘ └──────────┘   ├──────────────┤  ││
  259.          loop delay[Y/N]>Y  retry line error>1   >   Standard   <  ││
  260.          telephone number              busy>99   │   Daylight   │  ││
  261.              [1-613-745-3900                  ]  └──────────────┘  ││
  262.                                                                    ││
  263.        ────────────────────────────────────────────────────────────┘│
  264.         ────────────────────────────────────────────────────────────┘
  265.  
  266.       The arrows (which on the screen are represented by a scroll bar) are
  267.       the defualt values. Besides communication parameters, the panel
  268.       registers time-keeping parameters, which are of two kinds : time
  269.       zones and precision control.
  270.  
  271.       COM1 and COM2 ports are supported. The NRC modem presently operates
  272.       at 300 baud, eight data bits, one stop, no parity. Together with the
  273.       phone number these are  g i v e n s  and they should not be reset
  274.       unless more lines are open and these operate differently. The
  275.       'speaker' switch refers to the modem speaker. If you want a silent
  276.       operation set the switch to the off position. If 'Netware Sync'
  277.       is enabled, the program does not terminate at the end of the
  278.       NRC session but passes to the Time Server - File Server dialog.
  279.  
  280.       Three variables allow the user to 'calibrate' the received time:
  281.       (equipment) bias, clock tick intervals, and deciding whether to
  282.       factor in the measured loop delay. Starting with version 2.2 you
  283.       may select line- and busy- retries. Previously, receiving a line
  284.       error during dialling caused the session to terminate. Now you may
  285.       may retry the dialup up to 9 times. If line was busy, the previous
  286.       versions of TSERVE continued indefinitely until a key was struck.
  287.       Now, you may hang up after specified number of 'busy' responses.
  288.       You may enter any number from 0 to 99. Entering '99' retries for
  289.       busy means continue indefinitely, any other number triggers a
  290.       counter.
  291.  
  292.       TSERVE USER GUIDE                                               6
  293.       -----------------------------------------------------------------
  294.  
  295.             T i m e   Z o n e s -  TSERVE started by supporting North
  296.       American users only. In the last two months, however, we have receiv-
  297.       ed a number of inquiries via Compuserve, asking for the support of
  298.       European time zones. This demand has been answered by TSERVE starting
  299.       with version 2.0.  All world time zones are supported ! The user is
  300.       allowed to enter any time offset from the GMT as parameter.
  301.             The time zones panel lists North American time zones and a
  302.       'GMT offset' selection which allows the user to set up any hour/minute
  303.       offset from the GMT. When you press Enter or Tab in the Zones with
  304.       the GMT offset selected you will be prompted to enter the hour and
  305.       minute values. If you are in Alaska you will enter -9 in hours and 0
  306.       in minutes, if in Bombay enter 5 in hours and 30 minutes. Do not
  307.       adjust for daylight time ! That is done by the daylight switch !
  308.  
  309.       I M P O R T A N T : If you are updating from version 1.x of TSERVE
  310.                           you must first delete file TSPARMS.DAT and
  311.                           reset the parameters table before running
  312.                           TSERVE again. Program may not run properly if
  313.                           you omit this step.
  314.  
  315.             The manipulation of the table is very simple. Move forward
  316.       by pressing Enter (or TAB for the tables) and select values by
  317.       pressing space bar. In entry fields, clear fields forward by Enter.
  318.       You may quit the setup by pressing Esc at any time. If you make a
  319.       mistake you may return to a prefious field by Alt-Tab combination
  320.       for tables or F5 in entry fields.
  321.  
  322.             When you clear the last field (telephone number) you are asked
  323.       to accept the parameter settings. Once accepted, the values replace
  324.       whatever default or previous settings. After the parameters are
  325.       filed, the program asks if you want to open up a session with the
  326.       NRC host immediately. If you answer 'N'o the program terminates.
  327.  
  328.       I M P O R T A N T :  If you happen to live in the local area (of
  329.       code 613, that is the region of Ottawa,) the phone number must be
  330.       altered for local connection. The same applies for users from out-
  331.       side of North America. Also, do not forget to include dial-out
  332.       digits !!!
  333.  
  334.       TIME PRECISION FACTORS
  335.  
  336.             The time broadcast via telephone lines gives a very accurate
  337.       time but realistically it will not come close to transferring the
  338.       kind of accuracy it receives from a cesium atomic clock. A number
  339.       factors reduce the expectations of precisions from a the order of
  340.       nanoseconds to tens of milliseconds, and tenths of a second. First
  341.       of all, there is the transmission delay.
  342.             The transmitter, the NRC documentation says, sends the stop
  343.       bit of the carriage return (which terminates the time broadcast)
  344.       precisely at the full second. From the labs of INMS it travels via
  345.       trunk lines and microwave bands, through multiplexors, repeaters
  346.       and the occasional Strowger to arrive with some sort of a delay.
  347.       This delay the NRC proposes to measure by means of a transmit-
  348.       retransmit session with a client, in which the client sends a
  349.  
  350.  
  351.       TSERVE USER GUIDE                                               7
  352.       -----------------------------------------------------------------
  353.  
  354.       single character and the host returns it. The measured time is
  355.       then halved to represent the propagation delay of the transmitt-
  356.       ed time. The Council warns that for certain values received (25-
  357.       29 milliseconds of full loop delay) this technique of 'halving' does
  358.       not reliably represent the lag since such delay indicates the
  359.       signal has travelled one way overland and the other via satelite.
  360.           A second set of factors concerns the PC's timer. The method of
  361.       keeping time on the PC has not changed since the unveiling of the
  362.       machine in 1981 even though the processors have become vastly more
  363.       sophisticated. The venerable 8253 timer-chip's way of pushing the
  364.       clock while synchronizing the procesor and the bus is still the
  365.       canon. The result is that today's Intel processors can switch
  366.       between tasks six to eight times faster than register a 55 millisecond
  367.       tick. You may write a simple program to contemplate mysteries of PC
  368.       time. Set the time on a full second (using INT 21H function 2DH)
  369.       and then get the ticker value from the lower memory (by INT 21H
  370.       function 2CH) and when you display it, low and behold, it's still
  371.       b e f o r e  the time you set it. The other issue is the precision
  372.       of the oscillator. The standard - 1.19318 MHz - is a rarity most
  373.       of the time the quartz is a few Hertz off, sometimes quite a few
  374.       Hertz. Even if the chip is dead on, it falls behind 88 milliseconds
  375.       every day. On top of this notoriously crude time keeping, the timer
  376.       channel 0 can be manipulated by programs which can vary the time
  377.       divisor to suit their purposes, and some of them do without worrying
  378.       about such details as the system clock going haywire.
  379.             Further down the line come concerns regards the transfer of
  380.       the clock value between the system memory and CMOS, and the state
  381.       of lithium battery. The single greatest loss of the clock precision
  382.       originates in those transfers although in fairness it should be said
  383.       that this deviation has to do more with local time-keeping than
  384.       the accuracy of the transfer of NRC atime.
  385.  
  386.             The transfer speed between DCE and DTE, ie. the modem and the
  387.       PC represents another possible source of delays, the type of queuing
  388.       and buffering protocol, the buffer overrun protection and the delay
  389.       for the RTS-CTS negotiations set by the Hayes S9 register being the
  390.       chief players.
  391.             Finally, of course, there is the program code. Even though the
  392.       delay associated with the translation of the ASCII codes to binary
  393.       digits and executing a system interrupt may seem trivial in compar-
  394.       ison with the above, it is a factor when we compare the precision
  395.       standard which we are asked to duplicate. I am happy to report that
  396.       TSERVE was coded with this in mind. The program goes into a character
  397.       mode (as opposed to string input) for the NRC time reading and processes
  398.       the incoming time digits individually, using the time between their
  399.       arrival to do the binary conversion tricks and time zone calculations.
  400.  
  401.  
  402.       TSERVE USER GUIDE                                               8
  403.       -----------------------------------------------------------------
  404.  
  405.       PRECISION CONTROL
  406.  
  407.             So what can be done to come as close as possible to the NRC
  408.       standard ? The simplest way is to use the loop delay measurement
  409.       recommended by NRC. TSERVE performs the loop delay calculation
  410.       when the 'loop delay' parameter (on the panel above) reads 'Y'. When
  411.       the session runs the obtained value (the half-time) is displayed, and
  412.       recorded into a log. The measurement is done in such a way that it
  413.       includes also a half of the modem delay.
  414.             If you have access to some local source of precise time which
  415.       you can connect to your PC then I would suggest a calibrating
  416.       session. Take a sample of the actual delay from several NRC sessions
  417.       to determine if the lag is more or less constant. You may then enter
  418.       the average ms delay directly in TSERVE in the 'bias' parameter. In
  419.       that case you would also want to set the loop delay to 'N'.
  420.             A little bit of PC neurosurgery can turn the a PC - if you
  421.       can spare one - to a much more precise clock reading instrument.
  422.       It involves reprogramming the timer chip, as I have mentioned earlier.
  423.       That presumes a sophisticated programmer and a high degree of custom-
  424.       ization. The 'clck' variable in the parameter table prepares the
  425.       program for a new time keeping interval on the chip. By default, clck
  426.       displays is set to the 55 millisecond standard.
  427.  
  428.  
  429.       TIME VERIFICATION
  430.  
  431.       You may verify the time you have received by TSERVE by calling
  432.       NRC's voice time service at 613-745-1576. The second tick occurs
  433.       at the beginning of the tone after the announcement.
  434.  
  435.  
  436.       TSERVE SESSION LOG
  437.  
  438.       The results of each time sync session are recorded in an ASCII file
  439.       called TSLOG.DAT. An entry of a succesfully negotiated transfer
  440.       may look like this :
  441.  
  442.           Session 7-May-94  23:29:04 - synchronized time with NRC.
  443.           Time corrected by      -0.05 secs  Date not reset.
  444.           Propagation delay in loop : 0.10990 seconds.
  445.  
  446.       If an error occurs which forces the program to cancel a session
  447.       the log records the reason why. Please see TSERVE ERROR MESSAGES
  448.       below.
  449.  
  450.  
  451.       TSERVE USER GUIDE                                               9
  452.       -----------------------------------------------------------------
  453.  
  454.       NETWARE SERVER TIMESYNC DEMO
  455.  
  456.       The shareware package includes a demonstration of synchronizing
  457.       the time server station with a single file server and multiple
  458.       file servers. Like with the time download the transfer to servers
  459.       is automatic. In order to sync with  a file server the station must
  460.       be logged into that server as a valid user with minimum of console
  461.       operator access. For multiple server sync the user must be attached
  462.       from the time server station to all servers with those rights. The
  463.       session parameter 'Netware Sync' (see SETTING SESSION PARAMETERS
  464.       above) must be set to 'enable' for  TSERVE to load the Netware module
  465.       and pass control to it.
  466.            There are two Netware Sync modules in the package: NSSFX, for
  467.       single server, and NSMFX, for multiple (up to 8 sessions). Select the
  468.       one you want to use and rename it to 'TS.REX'. Make sure that TS.REX
  469.       is in the same directory as TSERVE.
  470.  
  471.          Briefly this is what happens when TS.REX executes: A check of
  472.       connection to the primary server is made when it is found a
  473.       display of the program appears on the screen with the name of
  474.       the workstation user and the file server. If no connection exists
  475.       the program terminates with a note in the log file. If the user
  476.       has console clearance the program then waits for the beginning
  477.       of the next full second (Netware does not allow setting for 1/100s
  478.       of a second) and then resets the file server timer. A test is then
  479.       performed to see if the time has sync-ed and the result is displayed.
  480.       The display stays on for a minute after which the program ends.
  481.       You may terminate the program after sync at any time by a keyboard
  482.       stroke.
  483.           With a multiple module, the same process takes place for all
  484.       the servers to which the user has a valid connection. The pause after
  485.       each file server session is 10 seconds.
  486.          The program has been tested with Netware 2.2, 3.11 and 3.12 and
  487.       in all instances it works fine. Netware 4.x has not been tested yet.
  488.       I make no representation of the fitness of this program to set the
  489.       Reference or Single Reference Server in the Netware 4 environment
  490.       although I encourage people to try it. It will most probably work.
  491.       The modules may be used with either the NETX style shells or VLMs.
  492.  
  493.       I M P O R T A N T  ! : Both modules, NSSFX and NSMFX can be run
  494.       from the command line. This allows you to resynchronize the servers
  495.       without having to make a call to NCR each time.
  496.  
  497.       I M P O R T A N T  !  The Netware synchronization modules are a demo.
  498.       Functionally they are equivalent to the licensed modules but they
  499.       will expire at some time in the future. Please, register as a user
  500.       if you plan to add this time server to your network facilities. The
  501.       terms are very reasonable. Please, read SHAREWAR.E.
  502.  
  503.  
  504.       TSERVE USER GUIDE                                               10
  505.       -----------------------------------------------------------------
  506.  
  507.       TROUBLESHOOTING AND TSERVE MESSAGES
  508.  
  509.             TSERVE has no special requirements other than a modem which
  510.       recognizes Hayes Smartmodem commands. Hopefully, it would be in
  511.       a working order. MS DOS version 3.3 is listed as the minimum. In
  512.       fact, version 3.3 is the earliest version that the program was
  513.       tested with. It may even work with an earlier release. There is
  514.       however one important restriction which has not yet been mentioned:
  515.       When running TSERVE make sure that you either
  516.  
  517.                  run the program with its own directory as
  518.                  the default path
  519.  
  520.                  or
  521.  
  522.                  you set an environmental variable TSERVE
  523.                  pointing to TSERVE directory.
  524.  
  525.       This is important because the program looks for the session
  526.       parameter file (TSPARMS.DAT) in the default path and if it does not
  527.       find one it reverts to the initial set it was shipped with.
  528.  
  529.             If you run into problems they will most likely be due to the
  530.       one of the following : a wrong session parameter, faulty modem,
  531.       a serial port problem. When a program catches a condition serious
  532.       enough to keep it from continuing, it displays a message (writes
  533.       to a log) and calls it quits.
  534.  
  535.       There are two kinds of screen messages : bottom line orientation
  536.       cues, which direct the program operator, and communication messages
  537.       in the lower of the two display windows.
  538.  
  539.       Bottom Line Orientation Cues
  540.       ----------------------------
  541.  
  542.       > To edit Session Parameters press any key .... <
  543.  
  544.         This message appears during the initial display and directs the
  545.         user to press a key if he wants to edit the parameter table.
  546.         See section SETTING SESSION PARAMETERS above.
  547.  
  548.       > Select by Space Bar, Move by Tab ...                 Esc=abort edit <
  549.       > Edit Fields ...   Enter to clear, F5= step back      Esc=abort edit <
  550.  
  551.         These two messages guide the user through the parameter panel
  552.         selections - the first one through the multiple choice tables,
  553.         the second through the entry fields below.
  554.  
  555.  
  556.       TSERVE USER GUIDE                                              11
  557.       -----------------------------------------------------------------
  558.  
  559.       > Accept [Y/N] ══>[_] <
  560.  
  561.         This is a prompt asking user to approve the entries in the
  562.         panel above. If the answer is 'Y' the parameters are written
  563.         to a file overwriting the previous set.
  564.  
  565.  
  566.       > Do you want to start a Time Synch session now ? [Y/N] ══>[_] <
  567.  
  568.         This is a prompt which appears after parameter editing has ended,
  569.         or has been aborted. It ask user if he/she wants to open up a
  570.         time-synchronizing session with the National Research Council
  571.         labs in Ottawa, Canada.
  572.  
  573.       > Follow Communication Messages above <
  574.  
  575.         Directs attention of the user to the displays in the windows
  576.         above. No user input required.
  577.  
  578.       > DOS Error [   ] loading Netware Sync program  ...wait !  <
  579.  
  580.         Reports on a DOS error received when a program tried to load
  581.         the Netware Sync module (TS.REX). The possible values in the
  582.         brackets are '002' - File not found, and '008' - Not enough
  583.         memory. If you get the latter you should try to optimize the
  584.         first MB of your PC's memory by using upper memory blocks or
  585.         by removing unused resident software. Consult MS DOS manuals
  586.         or guides for details on memory management.
  587.  
  588.       > Cannot open COMport       aborting program  ...wait ! <
  589.  
  590.         This usually happens when a serial port selected for communication
  591.         is not physically present. Check the comport, or try the other one
  592.         if you have two.
  593.  
  594.       Communication Messages
  595.       ----------------------
  596.  
  597.         ( These appear in the lower of the the display windows )
  598.  
  599.       >> ....Initializing Modem  <<
  600.  
  601.         This message appears briefly when the program prepares the
  602.         attached modem for a communication session.
  603.  
  604.  
  605.       TSERVE USER GUIDE                                              12
  606.       -----------------------------------------------------------------
  607.  
  608.  
  609.  
  610.       >> Error Initializing Modem... cannot continue <<
  611.  
  612.         Terminating condition !  Modem could not be prepared most prob-
  613.         ably because:   a) the power is off or the DC-adapter is
  614.                            defective
  615.                         b) the serial cable connection is loose or
  616.                            broken
  617.                         c) modem is not connected to the serial port
  618.                            specified in the SESSION PARAMETER TABLE
  619.                         d) program has been started from a directory
  620.                            other then TSERVE's resulting in loss of
  621.                            correct serial port selection.
  622.  
  623.       >> ...Dialling National Research Council  <<
  624.  
  625.         The modem is in the process of dialling the NRC time service.
  626.  
  627.  
  628.       >> ...Transmission Error <<
  629.  
  630.         This one you should never see. It signifies an internal problem.
  631.         If you keep a second copy of TSERVE, try that one. Some corrupt-
  632.         ion may have occured. Terminating error.
  633.  
  634.       >> ...Line busy ... retry <<
  635.  
  636.         Line is busy, the program redials until it connects or an error
  637.         occurs.
  638.  
  639.       >> ...No answer <<
  640.  
  641.         The NRC lab modem has not answered within 30 seconds. Equipm-
  642.         ent might be offline for maintenance. Try later. This terminat-
  643.         ates the program.
  644.  
  645.       >> ...No carrier <<
  646.  
  647.         No carrier was detected (or was lost) after a pickup. Terminating
  648.         condition. Again the only remedy is to try later.
  649.  
  650.       >> ...No dial tone <<
  651.  
  652.         No dial tone detected ...phone off the hook ?  Terminating cond-
  653.         ition.
  654.  
  655.  
  656.       TSERVE USER GUIDE                                              13
  657.       -----------------------------------------------------------------
  658.  
  659.       >> ....Starting a session <<
  660.  
  661.         NRC lab is now on the line. The session has started. Session is
  662.         in good shape.
  663.  
  664.  
  665.       >> ....Measuring Loop Delay <<
  666.  
  667.         Program is in the process of calculating loop delay. Indicates
  668.         normal session progress.
  669.  
  670.       >> ....Getting Date Info  <<
  671.  
  672.         Date Information is being transferred. Indicates normal session
  673.         progress.
  674.  
  675.       >> ....Synchronizing Time  <<
  676.  
  677.         Time digits are being read in. Indicates normal session
  678.         progress.
  679.  
  680.  
  681.       >> ....Transfer complete...Hanging Up <<
  682.  
  683.         The time synchronizing session has terminated : AOK.
  684.  
  685.  
  686.       GENIE BATCH SCHEDULER AND PROCESSOR
  687.  
  688.          To run TSERVE unattended, use GENIE, a program designed to
  689.        run executables and batch files from a secure network station.
  690.        GENIE, its setup program and user documentation are enclosed in
  691.        this package.
  692.  
  693.        T I P :  On most systems, you will need to run TSERVE only once
  694.        a day to keep the precision within a second. However it is a good
  695.        idea, if you run an installation with multiple servers to resync
  696.        the servers via NSMFX in GENIE every couple of hours or so.
  697.  
  698.       'DAYLIGHT' PROGRAM
  699.  
  700.          DAYLIGHT is a simple toggle switch which changes a pointer in the
  701.       TSERVE parameter file form daylight to standard time and vice-versa.
  702.       If you are presently on daylight zone time then DAYLIGHT will set
  703.       it to standard, if on standard then to daylight. On next running of
  704.       TSERVE the time will set to the new variant. Again, the program is
  705.       designed to be run on autoschedule (by GENIE, e.g.) to enable the
  706.       server time to be reset unattended.
  707.  
  708.  
  709.       TSERVE USER GUIDE                                              14
  710.       -----------------------------------------------------------------
  711.  
  712.  
  713.       NRC SESSION MARKERS
  714.  
  715.       The following are approximate time limits on the phases of the
  716.       automated time synchronization session :
  717.  
  718.       Modem Initialization :   2 - 12 seconds
  719.       Dialling to Connect  :  32 - 50 seconds
  720.       Loop Delay Test
  721.       (if selected)        :  0.05 - 0.9 seconds
  722.       Date Reading         :  0.05 - 15 seconds
  723.       Time Reading         :  0.05 - 15 seconds
  724.       Netware Sync
  725.       (if selected)        :  0.05 - 1 second ( + 60 seconds display)
  726.  
  727.       TSERVE ENVIRONMENTAL VARIABLE
  728.  
  729.       Starting with version 1.1a an environmental variable (TSERVE) may be
  730.       used to point to the directory which contains the session parameters
  731.       file (TSPARMS.DAT) for TSERVE. You may include a similar statement
  732.       to the one below in your AUTOEXEC.BAT file :
  733.  
  734.       SET TSERVE=C:\
  735.  
  736.       When TSERVE variable is present and it contains the file above you may
  737.       execute the program from any current directory. The log file for TSERVE
  738.       however will always be created in the current directory.
  739.  
  740.  
  741.       TSERVE USER GUIDE                                              15
  742.       -----------------------------------------------------------------
  743.  
  744.       RELEASE NOTES
  745.  
  746.       Version 1.1 features
  747.       (27/4/94)
  748.       ■ loop delay test may be switched off
  749.       ■ equipment bias may be entered as a constant
  750.       ■ a bug which has caused modem to fail initialization
  751.         after switch from COM1 to COM2 has been fixed
  752.       (7/5/94)
  753.       ■ created a safety check for received date after problems were rep-
  754.         orted with installation on 66 MHz 80486s'. The date reader will now
  755.         retry 15 times to read the full length of the date string. Failing
  756.         that the display and the log will complain that the date has been
  757.         lost. (However, inserting the retry loop seems to have corrected
  758.         the problem)
  759.  
  760.       (20/5/94)
  761.       ■ improved loop delay measurements - removed local queue-time-wait,
  762.         clocking loops to estimate time.
  763.       ■ user may break out of busy line by pressing a key
  764.  
  765.       version 1.1a
  766.       (10/6/94)
  767.  
  768.       ■ TSERVE environmental variable: defines directory in which parameter
  769.         file (TSPARMS.DAT) can be found
  770.  
  771.       (23/8/94)
  772.       ■ Date will not be reset unless the new value is received twice in
  773.         succession. This eliminates transmission errors sometimes causing
  774.         the date to reset to strange values.
  775.  
  776.       (31/8/94)
  777.       ■ The changes of 23/8 have eliminated errors but also caused under
  778.         certain circumstances the loss of date. Date capture was completely
  779.         reworked (like time it now passes by single characters).
  780.  
  781.       Version 2.0 features
  782.       (19/9/94)
  783.       ■ Support for all World Time Zones.
  784.       ■ Cancel call by any key during modem initialization of dialup.
  785.  
  786.       (20/10/94)
  787.       ■ Protection against 'unrecognized baud rate divisor' error (CErr=46)
  788.       ■ Break on unrecognized error on dialup.
  789.  
  790.       version 2.0a
  791.       (27/10/94)
  792.       ■ Protection against interrupted transmission or sudden loss of
  793.         carrier. Logging this condition as 'aborted - no characters
  794.         transmitted' or 'transmission error : ??'.
  795.  
  796.       (30/10/94)
  797.       ■ Protection against directory pointer mixup which results in
  798.         'line busy' error or switching to standard time.
  799.  
  800.  
  801.       TSERVE USER GUIDE                                              16
  802.       -----------------------------------------------------------------
  803.  
  804.       (15/11/94)
  805.       ■ time corrections now shown in seconds instead of 'ticks',
  806.         reported when run under Windows
  807.  
  808.       version 2.1
  809.       (27/11/94)
  810.       ■ -----------------not released -----------------
  811.  
  812.       version 2.2
  813.       (19/01/95)
  814.  
  815.       ■ reporting unidentified modem error by number
  816.       ■ larger buffer for dialing string
  817.       ■ retries counts for line problems and line busy condition
  818.       ■ corrects internal error in calculating the time adjustment
  819.  
  820.       version 2.2b
  821.       (24/2/95)
  822.  
  823.       ■ new compile parameters
  824.  
  825.       version 2.2c
  826.       (6/4/95)
  827.  
  828.       ■ break out from TS.REX session by Esc key
  829.       ■ corrects problem with DAYLIGHT.EXE corrupting TSPARMS.DAT
  830.         file
  831.  
  832.  
  833.  
  834.  
  835.  
  836.     FAQ about TSERVE
  837.  
  838.     Q. Can I run TSERVE under Windows 3.1 ?
  839.     A. Yes, but no guarantees. TSERVE.EXE is a DOS program with a
  840.        powerful engine which 'talks' directly to UART, the port
  841.        and modem. It does not abide by the serial com conventions
  842.        set for Windows. In addition the program uses other DOS
  843.        interrupts which may potentially be a source of trouble.
  844.        If you use TSERVE under Windows make sure you set up a
  845.        PIF file.
  846.  
  847.     Q. Can a workstation running TSERVE synchronize more than eight
  848.        Netware servers ?
  849.     A. Yes, it can. The maximum of 8 servers applies to one synchr-
  850.        onizing session. There may be as many consecutive sessions
  851.        as the user wishes. If there are more than 8 servers the
  852.        station must be able to log in (attach) to all of them with
  853.        a minimum of console operator privileges. To automate the
  854.        login/logout processes use the accompanying batch scheduler/
  855.        processor program GENIE.
  856.  
  857.     Q. When I make a second call to NRC quickly after the first one
  858.        TSERVE often reports an adjustment of several hundreths of
  859.        a second. Is there a problem ?
  860.     A. No, there is not. This is normal and expected and it does not
  861.        mean a time gap is opening in a linear fashion. Some of this
  862.        fluctuation is due to differing loop delays, some is a precis-
  863.        ion error in frequency division.
  864.  
  865.  
  866.  
  867.       TSERVE USER GUIDE                                              17
  868.       -----------------------------------------------------------------
  869.  
  870.     Q. Is there a difference between STIME.EXE and Netware utility
  871.        SYSTIME ?
  872.     A. Yes. STIME waits for next second rollover in the server's clock
  873.        before it synchronizes the station.
  874.  
  875.                             ---@@@---
  876.  
  877.      For further information on the offered product contact me at the
  878.      following addresses:
  879.  
  880.                              JIRI SEVERA
  881.                              101 Renfrew #3
  882.                              Ottawa, ON
  883.                              Canada  K1S 1Z6
  884.  
  885.  
  886.      Compuserve 70534,3475
  887.      Internet : jiri@ott.mmcl.ca,  ah158@freenet.carleton.ca
  888.  
  889.                                    - @@@@ -
  890.