home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / hbrt110.zip / hubroute.doc < prev    next >
Text File  |  1996-12-02  |  5KB  |  163 lines
  1.  
  2.            HubRoute 1.10 (c) Copyright 1996 Alberto Pasquale
  3.  
  4.                             F R E E W A R E
  5.         
  6.                                 LICENSE
  7.  
  8.     You may copy, distribute and use this program freely, provided you
  9.     do not modify the original archive and Copyrights.
  10.         
  11.         
  12.                                DISCLAIMER
  13.         
  14.     You are entitled to use this freeware program "as is". No guarantee
  15.     can be given on the performance of the program. The author will not
  16.     be liable for any damage or loss related to the use of this program.
  17.         
  18.         
  19.                                 OVERVIEW
  20.  
  21.  
  22.     This program allows to expand the Hub definitions in the Route.Cfg of
  23.     Squish (*).
  24.  
  25.     Fidonet (**) coordinators usually have to route netmail through some
  26.     Hubs, while Squish only allows wildcards for the entire net (e.g.
  27.     2:332/All is possible, 2:332/5?? is not).
  28.  
  29.     Problem:
  30.  
  31.       Let's suppose that I need to send netmail for the Hub 2:332/6?? and
  32.       2:332/8?? to the respective HCs.
  33.  
  34.       In route.cfg I will use a couple of defines and routing commands:
  35.  
  36.       DEFINE Hub600 2:332/600 601 602 606 608 609 610 617
  37.       DEFINE Hub800 2:332/800 801 804 805 806 807 809 811 812 813 831 836
  38.  
  39.       ROUTE  hold   Hub600
  40.       ROUTE  hold   Hub800
  41.  
  42.       Now, I have to check the nodelist weekly, in order to maintain the
  43.       DEFINEs updated with the real situation of the hubs, or list a lot of
  44.       nonexistent nodes, in the hope the new ones will be already covered.
  45.  
  46.  
  47.     Solution:
  48.  
  49.       Each time a new nodelist is received and compiled, just execute
  50.       HubRoute: it will update the Route.Cfg defines for you.
  51.  
  52.       See below for further details.
  53.  
  54.  
  55.  
  56.     Command line:
  57.  
  58.       HubRoute <route.cfg> <NODEX>
  59.  
  60.       <route.cfg> is the full path to the Squish route configuration file
  61.  
  62.       <NODEX> is the full path to the Version 7 nodelist "base" name
  63.  
  64.  
  65.     Operation:
  66.  
  67.       HubRoute looks for DEFINEs named "HUB*" and re-writes them taking the
  68.       information from the V7 nodelist (the addresses listed in the DEFINE
  69.       line are ignored, except for the first one which must be the HC).
  70.  
  71.       For this purpose HubRoute:
  72.  
  73.       - looks for the first address in <NODEX>.NDX (V7 index) and checks
  74.         that it is a HC;
  75.  
  76.       - copies this same address to the new DEFINE line;
  77.  
  78.       - appends to the HC address all the following Hub entries, as per
  79.         <NODEX>.DAT (V7 data);
  80.  
  81.       - skips points;
  82.  
  83.       - the expansion is suspended when the length exceeds 200 characters
  84.         (excluding the HC address): it may resume in the following DEFINE if
  85.         it uses the same HC address.
  86.  
  87.  
  88.     Example:
  89.  
  90.       To solve the Problem described above, you write in the Route.Cfg:
  91.  
  92.         DEFINE Hub600 2:332/600
  93.         DEFINE Hub800 2:332/800
  94.  
  95.         ROUTE  hold   Hub600
  96.         ROUTE  hold   Hub800
  97.  
  98.       Then you must add a call to HubRoute in the batch file that compiles
  99.       the new nodelists:
  100.  
  101.         fastlst
  102.         hubroute \bbs\squish\route.cfg \bbs\v7\nodex
  103.  
  104.       The DEFINE HUB* lines will be expanded and always kept up to date.
  105.  
  106.  
  107.     IMPORTANT:
  108.  
  109.       Since Squish has a limit of 255 characters in the lines of route.cfg
  110.       (after define substitution), HubRoute must divide very long hub
  111.       definitions into multiple defines.
  112.  
  113.       If you have such a problem, you must write something like:
  114.  
  115.         DEFINE Hub1000P1 2:332/1000
  116.         DEFINE Hub1000P2 2:332/1000
  117.         DEFINE Hub1000P3 2:332/1000
  118.  
  119.         ROUTE hold Hub1000P1
  120.         ROUTE hold Hub1000P2
  121.         ROUTE hold Hub1000P3
  122.  
  123.       HubRoute will fill-in the first DEFINE, then, if necessary, it will
  124.       continue with the second and third ones etc.
  125.  
  126.  
  127.     Notes:
  128.  
  129.     - Please note that any complete line of Route.Cfg (after define
  130.       substitutions) must not exceed the length of 255 characters.
  131.  
  132.       So you have about 49 characters left for "DEFINE <name> <HCadr>" and
  133.       "ROUTE <flavour> <modifier> <HCadr>", including heading space.
  134.  
  135.     - Please don't forget to call HubRoute manually the first time, or the
  136.       DEFINEs will remain undefined until hubroute is invoked by the
  137.       maintenance batch file :-)
  138.  
  139.  
  140.  
  141.     How to contact the author:
  142.  
  143.     Alberto Pasquale
  144.     Viale Verdi 106
  145.     41100 Modena
  146.     Italy
  147.  
  148.     alberto.pasquale@interbusiness.it
  149.  
  150.     2:332/504@fidonet 2:332/524@fidonet
  151.     81:439/501@OS2Net 81:439/502@OS2Net
  152.     +39-59-246112 V34+ 2 line ring-down
  153.     +39-59-246113 X75 2 line ring-down, G3 FAX
  154.  
  155.  
  156.     Credits
  157.  
  158.     *  Squish is a trademark of Lanius Corporation
  159.  
  160.     ** Fidonet and Fido are registered marks of Tom Jennings and Fido
  161.        Software
  162.  
  163.