home *** CD-ROM | disk | FTP | other *** search
/ Mega Top 1 / os2_top1.zip / os2_top1 / APPS / DATACOM / DIVERSEN / FDSYN103 / FDSYNC.DOC < prev    next >
Text File  |  1993-07-13  |  6KB  |  144 lines
  1. ■ FDSync, your hoopy Frontdoor log time synchroniser gubbins type program.
  2.  
  3.   Version 1.03, 15 July 1993
  4.  
  5.   By Mark Billinge
  6.  
  7.   (C) MDB Softworks 1993
  8.  
  9.  
  10. - Introduction
  11.  
  12.   FDSync will synchronise your PC's internal clock to the internal clock of
  13.   a remote computer (the remote doesn't have to be a PC) using your
  14.   FrontDoor log file.
  15.  
  16.   The program was developed after seeing another program that did exactly the
  17.   same thing.  Unfortunately that program was very clumsy to set up, and had
  18.   a wierd very specific bug that made it unsuitable for use when synchronisng
  19.   to a wide number of mailers.  I'll leave you to guess what that bug is (no
  20.   chance!).
  21.  
  22.   FDSync is designed to be very easy to use, and will not interfere with log
  23.   use on multitasking systems.  If it finds the log to be already in use,
  24.   it will exit to DOS, telling you what's wrong.
  25.  
  26.  
  27. - Installation
  28.  
  29.   The contents of the FDSync.ZIP should be as follows:
  30.  
  31.   Length  Method   Size  Ratio   Date    Time    CRC-32  Attr  Name
  32.   ------  ------   ----- -----   ----    ----   -------- ----  ----
  33.    11357  DeflatX  11223   2%  07-07-93  11:28  6f190bbb --w-  FDSYNC.EXE
  34.     ----  DeflatX   ----  ---  05-07-93  -----  -------- --w-  FDSYNC.DOC
  35.   ------          ------  ---                                  -------
  36.    -----           -----  ---                                        2
  37.  
  38.   As you can see, I have wiped out lots of information about FDSYNC.DOC.  That
  39.   is simply because I cannot tell you the CRC and subsequent compressed length
  40.   of a text file I have not yet written...  Just check FDSYNC has the same
  41.   CRC-32 though.
  42.  
  43.   Put FDSync.EXE in any directory, and that's installation.  All you need
  44.   to do now is to decide on your command line options.
  45.  
  46.   The command line is as follows:
  47.  
  48.   FDSync <FrontDoor log file> <node number> [<time difference>]
  49.  
  50.   FrontDoor log file is obvious, node number is the node number that you
  51.   want to synchronise with (don't use point zero - i.e. 2:251/24.0 - in
  52.   normal use, but there may be times when you need to.  Keep that in mind
  53.   if things go wrong) and time difference is the number of seconds different
  54.   that your clock should be to the remote PC.
  55.  
  56.   Time difference is there for use in the event that you are setting you PC
  57.   by the clock of a PC in a different timezone, and also to compensate for
  58.   FrontDoor's silly bug (see 'Accuracy').  It can be either positive or
  59.   negative.  This number is added on to your PC's clock, so use positive
  60.   numbers to put your clock FORWARD and negative to but it BACK.  Remember
  61.   that one hour is 3600 seconds.
  62.  
  63.  
  64. - How to set your clock accurately from the remote PC
  65.   
  66.   FrontDoor v2.02 (the only version I have used) has a small bug that usually
  67.   prevents you from being able to set your clock exactly to within a second
  68.   of the remote PC.  This bug is that it calculates the `Tranx' numbers at
  69.   the time the two systems connect, NOT at the time the Tranx numbers are
  70.   printed into the log file.
  71.  
  72.   However, with FDSync v1.01 I believe I have overcome this small bug, by
  73.   calculating from the log file the number of seconds that elapse between
  74.   the modems connecting and FrontDoor connecting with EMSI.  Hurrah, this
  75.   now means in theory that you clock should be accurate to ±0.5 seconds of
  76.   the remote clock.  In practice, recon on accuracy of ±2 seconds maximum.
  77.  
  78.   One point to remember is that for your clock to be synchronised, you need
  79.   to have called the remote system since it was last synchronised.  FDSync
  80.   is clever enough to not synchronise your clock twice to the same log entry,
  81.   so no harm will come of executing it every time your mailer is exited (I
  82.   do).  However, if your clock goes wrong after a few weeks and you want to
  83.   resynchronise it, you must call the remote system again.  Simply trying to
  84.   resynchronise your clock based on the old log is not wise!
  85.   
  86.   FDSync stores a log file of its own, called FDSync.LOG, in the directory
  87.   that the executable resides in.  It also writes a very small file called
  88.   FDSync.CFG.  Feel free to delete FDSync.LOG, but leave FDSync.CFG alone
  89.   unless you want to mess up your internal clock....
  90.  
  91.   Another point to remember is that you don't need to have FrontDoor set up
  92.   to send and receive files.  In fact, you could if you wished set up
  93.   FrontDoor simply so you can have an accurate clock thanks to FDSync!
  94.  
  95.  
  96. - Distribution
  97.  
  98.   Copy freely, just don't change anything.  In fact, upload this to every
  99.   BBS you know.
  100.  
  101.   FDSync is released as Noteware.  If you use it, send me a note saying how
  102.   much you love it.  :-)
  103.  
  104.  
  105. - Revision history:
  106.  
  107.   v1.00      - Didn't work.  Synchronised time completely wrong!
  108.   v1.01      - Does work, very well too.  First public release.
  109.   v1.02      - Found one or two bugs when using on some PCs.
  110.   v1.03      - Public release, no known bugs as such. 
  111.  
  112. - Known problems
  113.  
  114.   You cannot use FDSync if the log is in use by another program that prevents
  115.   access to the log.  Such a program is, unfortunately, FrontDoor.  The best
  116.   way to have FDSync set up is to install it in your mailer batch file, just
  117.   before FD.EXE is executed.  This is how I have it set up and it works
  118.   perfectly.
  119.   
  120.   Since FDSync is fast, you shouldn't have much of a time delay when it runs
  121.   unless you have a slow PC (16 Mhz or less) or an excessively large log
  122.   ( > 800Kb).  It's a good idea to purge your logs often anyway.  Remember
  123.   that FDSync also creates its own log that needs purging.
  124.  
  125.  
  126. - Contacting the Author
  127.  
  128.   I'm currently not sure where I'll be by the time you read this, so the
  129.   following addresses are not certain.  However, you can be sure to be able
  130.   to contact me at the paper mailing address shown, since mail can be
  131.   forwarded to me wherever I happen to be.
  132.  
  133.   Paper mail:   Mark Billinge
  134.                 15 Manor Road
  135.                 Selsey
  136.                 West Sussex
  137.                 PO20 0SB
  138.                 ENGLAND
  139.  
  140.   Electronic (.ftn) mail (Limited hours, so only call at ZMH or send routed):
  141.   2:251/26@Fidonet.org, 213:1020/2@Pafownet.FTN, 64:7000/11@worldnet.ftn
  142.  
  143.   Voice phone: +44-243-602492 (International) or (0243) 602492 (UK) 
  144.