home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / lan / tsync220.zip / TIMESYNC.DOC < prev    next >
Text File  |  1993-07-31  |  23KB  |  591 lines
  1.     TIMESYNC Version 2.14       04-Aug-1992                    Page  1
  2.     ──────────────────────────────────────────────────────────────────
  3.  
  4.  
  5.  
  6.  
  7.  
  8. ┌────────┬─────┬───┐   ┌────┬──────┬─────────┬──┐      ┌──┬───┐   ┌───┬────────┐
  9. │        │     │   └┐ ┌┘    │      │         │  └┐    ┌┘  │   │   │   │        │
  10. └─┐   ┌──┤  ┌┬─┘    └─┘     │  ┌───┤   ┌──┐  ├┐  └┐  ┌┘  ┌┘   └┐  │   │  ┌───┐ │
  11.   │   │  │  ││    ├┐   ┌┤   │  │   │   │  └──┘└┐  └──┘  ┌┘┌─┐  │  │   │  │   └─┘
  12.   │   │  │  ││    │└───┘│   │  └─┐ │   └─────┐ └┐      ┌┘ │ │  └┐ │   │  │
  13.   │   │  │  ││    │     │   │  ┌─┘ └────┐    │  └─┐  ┌┬┘  │ └┐  │ │   │  │
  14.   │   │  │  ││    │     │   │  │  ┌──┐  │    │    │  ││   │  │  └─┘   │  │   ┌─┐
  15.   │   ├──┘  └┴─┐  │     │   │  └──┴┐ └──┘    │    │  ││   │  └┐       │  └───┘ │
  16.   │   │        │  │     │   │      │         │    │  ││   │   │       │        │
  17.   └───┴────────┴──┘     └───┴──────┴─────────┘    └──┘└───┘   └───────┴────────┘
  18.  
  19.                                  Version 2.14
  20.  
  21.     (C) Frank Altenburg and ACTUS  1991 1992   All rigths reserved     
  22.  
  23.     DIE BOX Darmstadt                           2:2405/1
  24.     RemoteAccess Help/Register Germany (EURAS)
  25.  
  26.  
  27.     Lots of thanks dedicated to
  28.  
  29.               Roland Mausolf, Hans Peter Bertram, Wolfram Sperber,
  30.               Richard Keil, Peter Jansens und Peter Garben
  31.     for their friendly input
  32.  
  33.     and to    Peter Garben, Fred Busch, Paul Ellison, Hendrik Bohm,
  34.               und Peter Janssens
  35.     for their patience as Beta testers.
  36.  
  37.     My special thanks to Fred Busch   for the Binkley Betatest and the
  38.                                       english documentation
  39.                     to Thomas Melzer  for the C++ classes to setting
  40.                                       the XT hardware clock.
  41.                 and to Rudi Heeb      for the C code to setting the
  42.                                       server clock in a LANTASTIC LAN
  43.  
  44.     TIMESYNC Version 2.14       04-Aug-1992                    Page  2
  45.     ──────────────────────────────────────────────────────────────────
  46.  
  47.         Licence agreements:    
  48.   
  49.         "TIMESYNC" is the bundle of applications and documentations which 
  50.         is delivered as packet by the ACTUS company.
  51.   
  52.         TIMESYNC is a copyrighted product and may only be used in 
  53.         accordance to this licence agreements which is accepted by the 
  54.         user up from the first installation.
  55.   
  56.         This programm is shareware. You may use it for 21 days under
  57.         testing conditions to see if it fits your requirements.    
  58.         After a 21 days' test period you HAVE TO REGISTER your copy with  
  59.         the following form IMMEDIATELY.                 
  60.   
  61.         The registration permits to use TIMESYNC and all coming upgrades
  62.         as long as you like under the actual conditions which you will 
  63.         receive it with your upgrade releases.
  64.   
  65.         TIMESYNC may not be hacked nor changed in any case.
  66.   
  67.         TIMESYNC may be handed to other users so far the packet is not
  68.         changed in any way. If you payed for the registration you may
  69.         require your money back from the receiver but may not require  
  70.         any additional fee on it.
  71.   
  72.         TIMESYNC may not be distributed in a software library or equivalent
  73.         on commercial interest without a formal permission by ACTUS before
  74.         any activities.
  75.  
  76.         TIMESYNC may not be used for illegal purposes in any way. 
  77.   
  78.         ACTUS does not take responsibility for any damages caused by the
  79.         use of TIMESYNC or an user's incapability to install it.
  80.  
  81.  
  82.  
  83.     TIMESYNC Version 2.14       04-Aug-1992                    Page  3
  84.     ──────────────────────────────────────────────────────────────────
  85.  
  86.     How to register:    
  87.     ────────────────
  88.  
  89.     Commercial version:   
  90.  
  91.       Commercial means that the system to run TIMESYNC is located
  92.       in any business environment (e. g. office rooms) and/or is
  93.       used on any commercial purpose system.
  94.  
  95.     All other usage is assumed to be non-commercial.
  96.  
  97.  
  98.     Register fees:
  99.  
  100.     Non-commercial version                   Commercial version  
  101.  
  102.       DM   15,--                               DM   30,--
  103.       US$  10,--                               US$  20,--
  104.  
  105.     The unregistered shareware version does support only 1 node to    
  106.     be installed to synchronize your system's time. 
  107.     Creating and sending netmail is not available, too.
  108.  
  109.  
  110.     Please send your completed register form attaching the register
  111.     fee (cash or check) to:
  112.  
  113.                       ACTUS
  114.                       Frank Altenburg
  115.                       Wickopweg 9
  116.  
  117.                       D-6100 Darmstadt
  118.                       GERMANY
  119.  
  120.                       FIDO 2:2405/1
  121.  
  122.  
  123.     TIMESYNC Version 2.14       04-Aug-1992                    Page  4
  124.     ──────────────────────────────────────────────────────────────────
  125.  
  126.                  TIMESYNC Registration Form      
  127.  
  128.     Your system's name:______________________________________________
  129.  
  130.     Your sysop name:_________________________________________________
  131.  
  132.       (Both names are stored in our database and have to be used 
  133.       strictly identical in your TIMESYNC config menu)
  134.  
  135.  
  136.     Network name & address:__________________________________________
  137.  
  138.     Other nets where you are member:        
  139.  
  140.     _________________________________________________________________
  141.  
  142.     Your comms phone number:_________________________________________
  143.  
  144.     Your voice phone number:_________________________________________
  145.  
  146.     Your mail address:     
  147.  
  148.     _________________________________________________________________
  149.  
  150.     _________________________________________________________________
  151.  
  152.     _________________________________________________________________
  153.  
  154.  
  155.     Commercial version to be registerd (YES / NO):___________________
  156.  
  157.     Register fee:____________________ for __________ copies.
  158.  
  159.     Signiture:    
  160.  
  161.     X________________________________________________________________
  162.  
  163.     What do you like with TIMESYNC ?
  164.  
  165.     _________________________________________________________________
  166.  
  167.     _________________________________________________________________
  168.  
  169.     _________________________________________________________________
  170.  
  171.     What should be changed ?                      
  172.  
  173.     _________________________________________________________________
  174.  
  175.     _________________________________________________________________
  176.  
  177.     _________________________________________________________________
  178.  
  179.     TIMESYNC Version 2.14       04-Aug-1992                    Page  5
  180.     ──────────────────────────────────────────────────────────────────
  181.  
  182.     Introduction:
  183.  
  184.     In the past time I regularly had to adjust the system time of my
  185.     BBS. Then after the release of FrontDoor 2.01 (the superior
  186.     mailerpackage of Joaquim Homrighausen) I noticed the 'Tranx:' line
  187.     in the logfile. I noticed that the Tranx number reflects the
  188.     system time of my system as well as the remote system in seconds
  189.     since Jan 1st, 1970, in Unix/Hex format. Thus I could get the
  190.     difference of these two timestamps and adjust my system clock.
  191.     This is exactly what this program does.
  192.  
  193.     Cause the 'Tranx:' line is also used in a modified version of
  194.     Binkley/2.50 (enriched by EMSI) there rose the same requirement
  195.     to have a time control & adjust utility by those bbs sysops.
  196.     So I was encouraged to customize the software for BT/EMSI also.
  197.  
  198.     Since GETTIME 1.00 1.01 and 1.02 were released this little utility
  199.     was requested by more than 600 sysops from all over the world during
  200.     two month!
  201.  
  202.     This new version 2.10 is totally redesigned using Borland C++ (with
  203.     OOP) and supplies a couple of additional features.       
  204.  
  205.     It serves both FrontDoor and Binkley (EMSI version only) mailers.
  206.  
  207.  
  208.       TIMESYNC Version 2.14       04-Aug-1992                    Page  6
  209.       ──────────────────────────────────────────────────────────────────
  210.  
  211.       New with version 2.00:
  212.       ----------------------
  213.       + Configuration of more than one node entry. Allows a wildcard (*).
  214.       (Example: 2:249/* for all nodes and points of net 249/zone 2
  215.       or 2:* for all nodes and points of zone 2)
  216.  
  217.       + Facility to configure every node entry looking for incoming 
  218.         and/or outgoing calls.
  219.  
  220.       + Ability to define every node entry with a time zone difference.
  221.  
  222.       + Switch for each node entry to enable a netmail msg. which can be
  223.         be configured personally.
  224.         This mail will be sent to the sysop if maxdiff exceeded.
  225.  
  226.       + Synchronization switch for every node entry.
  227.         Your BBS will be synchronized if the difference is less maxdiff.
  228.  
  229.       + TIMESYNC reads the FD environment variable, and looks for
  230.         SETUP.FD. All needed informations are included in this file.
  231.  
  232.       + NetMail is configurable as an ASCII text file and can be work
  233.         with 7 macros.
  234.     
  235.       + Creation of a log (individual name) for all activities and the
  236.         reference nodes.
  237.  
  238.       + The log includes the synchronized node.
  239.  
  240.       + The haredware clock of pc XT - if present - is now auto-updated.
  241.       
  242.       + TIMESYNC handles the BINKLEY Version 2.50 and greater with
  243.         EMSI-option. Make sure that the LOG entries are in english using
  244.        'Dialing, Ring, Connect, SysOp, Tranx, End of ...etc.'
  245.         Using log level +4 or +5 gives the chance to choose the reference
  246.         time system depending on  'Called' _or_ 'Calling' connections
  247.         or both.
  248.         Using log level -4 or -5 gives _no_ chance to choose the reference
  249.         time system depending on  'Called' _or_ 'Calling' connections
  250.         cause the log does not show 'Ring' for imcoming call or 'Dialing'
  251.         for outgoing calls.
  252.         In this case the defined node is used both
  253.  
  254.       + In Binkley mode it reads the BT config file (e. g. BINKLEY.CFG)
  255.         and gets all needed information from it.
  256.  
  257.       + ability to set the hardware clock on multifunction card in an XT.
  258.  
  259.     New with version 2.01:
  260.     ----------------------
  261.     * TIMESYNC now writes the correct date and time into the NET Mail.
  262.  
  263.     + In Binkley mode TIMESYNC writes Binkley style logentries.
  264.  
  265.     + TIMESYNC can handle the FD 2.01 (SETUP.FD) and FD 2.00 (FD.SYS)
  266.       configuration files.
  267.  
  268.     TIMESYNC Version 2.14       04-Aug-1992                    Page  7
  269.     ──────────────────────────────────────────────────────────────────
  270.  
  271.        New with Version 2.10:
  272.        ----------------------
  273.        * Config modus totally redesigned for easy handling.
  274.        * Fast scanning of FD / BINKLEY - logs.                
  275.        + Individual netmail to each reference node.
  276.        * The SUBJECT of the netmail is posted into the 1st line
  277.          of the netmail.                
  278.        * Correct handling of changing time and date at midnight.
  279.  
  280.  
  281.        New with Version 2.11:
  282.        ----------------------
  283.        * Shared open modus for FD/BINKLEY log and config file
  284.        * Log file scanning more fastened
  285.        * Always writing to log file also if nothing was to do
  286.        + Integrated debug modus to find out if TIMESYNC does not
  287.          work in some cases
  288.        + New command line parameter '/R' for rescanning the log
  289.          from the beginning at any time
  290.        * Redesign of using command line parameters plus some changes
  291.          for configuration mode
  292.        * Change of log entrance for sent NetMails
  293.        + Identification code at the 1st position of TIMESYNC config
  294.          file for future update version of TIMESYNC
  295.        + For NOVELL (2.2 / 3.11) networks (not NWLITE or LANTASTIC!):
  296.          the server time can be set depending of the flag setup during
  297.          config mode of TIMESYNC, therefor the server login must be
  298.          as SUPERVISOR.
  299.      
  300.        New with Version 2.12:
  301.        ----------------------
  302.        + Included Code to set the time of a LANTASTIC server
  303.  
  304.        New with Version 2.14:
  305.        ----------------------
  306.        * No ^AINTL - Line in interzone Mails. Fixed.
  307.        * If TIMESYNC has to generate a TIMESYNC.CFG file, this was demaged.
  308.          Fixed.
  309.        + Adress of the originator in NET Mails is now configurable.
  310.  
  311.     TIMESYNC Version 2.14       04-Aug-1992                    Page  8
  312.     ──────────────────────────────────────────────────────────────────
  313.  
  314.      Installation:
  315.      1.) Copy all TIMESYNC files into your FrontDoor or Binkley system
  316.          directory.
  317.  
  318.          In a LANTASTIC LAN: Copy the file SST.COM to the server and
  319.          insert the following 3 lines in your AUTOEXEC.BAT of your server:
  320.  
  321.             NET MESSAGE/DISABLE POP
  322.             NET MESSAGE/DISABLE BEEP
  323.             SST
  324.  
  325.          TIMESYNC uses the LANTASTIC Messagequeue to transmit the time-
  326.          informations. So you have to switch off the BEEP and POP.
  327.  
  328.          If TIMESYNC Version 2.01 is already installed:
  329.  
  330.          1A.) Copy file 201TO210.EXE into the directory where 
  331.               TIMESYNC.CFG is located.
  332.          1B.) Call 201TO210.EXE to change TIMESYNC.CFG from the old
  333.               into the new format automatically.
  334.          1C.) Delete 201TO210.EXE from your system.
  335.  
  336.          If TIMESYNC Version 2.10 is already installed:
  337.  
  338.      Nothing must be changed manually, TIMESYNC 2.14 is going to
  339.      adjust the .CFG file automatically for you.
  340.      
  341.          ATTENTION: 
  342.          If you swap from GETTIME 1.00, 1.01, 1.02 or TIMESYNC 2.00 
  343.          to TIMESYNC 2.14 you _must_ delete TIMESYNC.CFG!
  344.  
  345.      2.) Call "TIMESYNC /C" (FrontDoor config mode) or            
  346.          call "TIMESYNC /B=BINKLEY.CFG /C" (Binkley config mode)
  347.          to create the file TIMESYNC.CFG (look below for editing). 
  348.  
  349.      3.) In SETUP.EXE (FD2.00) oder FDSETUP.EXE (FD2.01 und FD2.02)
  350.          at  'Mailer - Log'  set "YES" at the following items:
  351.  
  352.           $ Accounting info
  353.           + Brief messages
  354.           : Transaction info
  355.           = Modem responses
  356.  
  357.          TIMESYNC needs the log entries which are created hereby to
  358.          do its work with high security.
  359.  
  360.          Set 'LogLevel' to +4/+5/-4/-5 in BINKLEY's config file.
  361.  
  362.          Attention:
  363.          Log levels 1, 2 or 3 do not work correct with TIMESYNC.
  364.          Your BINKLEY.LNG must carry the _english_ log entry codes.
  365.  
  366.      4.) Add following sequence to your batch file for the mail import 
  367.          batch routine:
  368.  
  369.           FrontDoor sample:     
  370.           -----------------
  371.           (lable) :IMPORT               
  372.                    TOSSCAN TOSS         
  373.                    TIMESYNC             
  374.                    GOTO LOOP            
  375.              
  376.           Binkley sample:
  377.           ---------------
  378.           (lable) :IMPORT
  379.                    QM TOSS...
  380.                    TIMESYNC /B=C:\BINKLEY\BINKLEY.CFG
  381.                    GOTO LOOP
  382.  
  383.     TIMESYNC Version 2.14       04-Aug-1992                    Page  9
  384.     ──────────────────────────────────────────────────────────────────
  385.  
  386.     Syntax:
  387.  
  388.       TIMESYNC [ /C | /c ] 
  389.            for FRONTDOOR config mode.
  390.  
  391.       TIMESYNC /B=BINKLEY.CFG [ /C | /c ]
  392.            for BINKLEY config mode.
  393.  
  394.       TIMESYNC [ /H | /h | /? ]
  395.            Shows the syntax help screen.
  396.  
  397.       TIMESYNC
  398.            Scans the log files and synchronizes the time
  399.            of _FrontDoor_ systems.
  400.  
  401.       TIMESYNC /B=BINKLEY.CFG
  402.            Scans the log files and synchronizes the time
  403.            of _Binkley_ systems.
  404.            E. g. TIMESYNC /B=C:\BINKLEY\BINKLEY.CFG
  405.  
  406.     ERRORLEVELS:
  407.     ------------
  408.     The programm exits with the following errorlevels:
  409.  
  410.     4 Other error found
  411.     3 LOG file not found (or not existing)
  412.     2 Time difference greater then maximum difference (time not changed)
  413.     1 Time changed
  414.     0 Nothing to do (time not changed)
  415.  
  416.     The program writes the 'Tranx:' line into its defined config file.
  417.     Thus it changes the system time or it writes a NetMail only if a new 
  418.     call from/to one of the configured reference nodes is completed.
  419.     It writes an entry into the logfile including the node and all new
  420.     timesync activities to be controlled later if someone likes it.
  421.  
  422.  
  423.     TIMESYNC Version 2.14       04-Aug-1992                   Page  10
  424.     ──────────────────────────────────────────────────────────────────
  425.  
  426.     CONFIG MODE:            
  427.  
  428.     TIMESYNC CONFIGURATION Version 2.14
  429.     (c) Frank Altenburg     All rights reserved
  430.  
  431.     DIE BOX Darmstadt 2:2405/1
  432.  
  433.     <1> System name       :   Name of your system   (*)
  434.  
  435.     <2> Sysops name       :   Name of the sysop     (*)
  436.  
  437.     <3> External command  :   DOS command to be called after the end of
  438.                               synchronizing (max. 50 cyphers).
  439.                               The command line may have the following
  440.                               codes to be used at the start of the pgm:
  441.  
  442.                                 %h = hour  
  443.                                 %m = minute
  444.                                 %s = second 
  445.                                 %d = day (numeric format)        
  446.                                 %t = day (in 3 digits format: mon, tue,..)
  447.                                 %n = month (numeric format)       
  448.                                 %c = month (in 3 digits format: jan, feb,..)
  449.                                 %y = year (in 4 digits format: e. g. 1991)
  450.                                 %Y = year (in 2 digits format: e. g. 91)
  451.                                 %r = carrige return
  452.                                 %l = line feed)
  453.                                 %z = EOT (Ctrl-Z) (0x1a)
  454.  
  455.                               E. g. key in the following:
  456.                               ECHO Time: %h:%m:%s %t, %d. %c. %y%r%n
  457.  
  458.                               to receive this command line:
  459.                               ECHO Time: 12:24:58 Mon, 16. Sep. 1991(CR)(LF)
  460.  
  461.  
  462.     <4> Max. diff time    :   Maximum time difference to synchronize.
  463.                               No synchronizing if amount of max. diff time 
  464.                               is crossed.
  465.  
  466.     <5> TIMESYNC Logfile  :   Your dedicated TIMESYNC log to store all  
  467.                               activities. If no entry: the log file named
  468.                               in your FDSETUP or BINKLEY.CFG is used.
  469.  
  470.    
  471.  
  472.     TIMESYNC Version 2.14       04-Aug-1992                   Page  11
  473.     ──────────────────────────────────────────────────────────────────
  474.  
  475.     <6> NET Mail File     :      The netmail to be sent to a system if the
  476.         {+}                      'max. time diff' to yours is crossed.
  477.                                  You may use the following macros:      
  478.  
  479.                                  %orignode   Node (sender)      
  480.                                  %destnode   Node (receiver)
  481.                                  %origsysop  Sysop name (sender)
  482.                                  %destsysop  Sysop name (receiver)
  483.                                  %origsystem System name (sender)
  484.                                  %difference Time difference of both systemse
  485.                                  %maxdiff    Configured maximam difference
  486.  
  487.                                  The 1st line of this file is carried into
  488.                                  the 'subject' line of the netmail.            
  489.                                  (No macro allowed!)               
  490.  
  491.     <7> NOVELL installed:        if you use a NOVELL LAN and want to set the
  492.                                  servertime, set this option to yes.
  493.  
  494.     <8> LANTASTIC installed:     if you use a LANTASTIC LAN and want to set
  495.                                  the servertime, set this option to yes. 
  496.  
  497.     <9> Node configuration:      Entry/change/delete/show node number.
  498.  
  499.     <Q> Quit and save configuration
  500.  
  501.     Input 1..3, Q : 
  502.  
  503.  
  504.     NODE CONFIGURATION :
  505.  
  506.     TIMESYNC CONFIGURATION Version 2.14
  507.     (c) Frank Altenburg     All rights reserved
  508.  
  509.     DIE BOX Darmstadt 2:2405/1
  510.  
  511.     <1> Insert a Node     : Key in a new node number
  512.     <2> Delete a Node     : Delete an existing node number
  513.     <3> Change a Node     : Change an existing node number
  514.     <Q> Goto Main Menu    : Return to main menu
  515.  
  516.     Input 1..3, Q : 
  517.  
  518.  
  519.     Node                Diff. Outg. Inc.  Sync. Netmail Origin
  520.     2:*                 0     No    Yes   No    Yes   2:2405/1   D:\FD\TIMESYNC.ENG
  521.     2:2405/*            0     Yes   Yes   No    Yes   2:2405/1   D:\FD\TIMESYNC.GER     
  522.     2:2405/1            0     Yes   Yes   Yes   No    2:2405/1   
  523.  
  524.  
  525.     TIMESYNC Version 2.14       04-Aug-1992                   Page  12
  526.     ──────────────────────────────────────────────────────────────────
  527.  
  528.     INSERT / CHANGE A NODE ENTRY:            
  529.  
  530.     <1> Node              : 2:2405/*
  531.     <2> Time Difference   : 0
  532.     <3> Calling           : Yes       
  533.     <4> Called            : Yes       
  534.     <5> Syncronizing      : No        
  535.     <6> Send NET-Mail     : Yes       
  536.     <7> NET Mail File     : D:\FD\TIMESYNC.GER
  537.     <8> Origin Adress     : 0 = 2:2405/1
  538.  
  539.     <Q> Quit and go to Node-config menu
  540.  
  541.     Input 1..7, Q :
  542.  
  543.  
  544.     Activating the DEBUG mode:    
  545.     --------------------------
  546.  
  547.     The DEBUG mode is to be installed via environment variable in your
  548.     AUTOEXEC.BAT file:
  549.  
  550.     SET TIMESYNC=DEBUG0      Log entries are written parallel to the
  551.                              screen outputs
  552.  
  553.     SET TIMESYNC=DEBUG1      100% log entries of _all_ TIMESYNC activities
  554.                              (reducing the performence slightly  cause of
  555.                  lots to writing inro the log)
  556.  
  557.     To use the DEBUG mode it is recommended to install a dedicated TIMESYNC
  558.     log file for that purpose ('TIMESYNC /C') cause in that mode there can
  559.     be created a very large log.
  560.  
  561.  
  562.  
  563.     If TIMESYNC can't be activated at all:
  564.     --------------------------------------
  565.     
  566.     Please use 'DEBUG mode 1' (SET TIMESYNC=DEBUG1) and  send the FD 
  567.     (or BT) log file, the config file of your TIMESYNC installation and 
  568.     the TIMESYNC.LOG file to my support system (2:2405/1.10) attaching 
  569.     a message with explanations about your system etc. to get help.
  570.     
  571.  
  572.  
  573.     ANY COMMENTS, IDEAS, BUGS?
  574.     --------------------------
  575.  
  576.     Comments or questions can be directed to me via netmail at my 
  577.     FidoNet address (2:2405/1.10).
  578.  
  579.     If you find a bug or any better idea, please tell me, so I can 
  580.     generate a new version.
  581.  
  582.  
  583.  
  584.     Have fun with synchronizing your system time
  585.     and always have a good time!
  586.  
  587.     Frank Altenburg
  588.  
  589.         
  590.  
  591.