home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / ERRFLG28.RAR / ERRFLAGS.DOC < prev    next >
Text File  |  2000-07-20  |  8KB  |  190 lines
  1.   ErrFlags version 2.8
  2.   --------------------
  3.  
  4.     This program checks incoming nodelist segments for illegal and
  5.     redundant nodelist flags, and makes sure submitted segments are up to
  6.     standard. Fully configurable to suit <othernets> as well as fidonet.
  7.  
  8.     Openware - This program may be used and copied without any cost.
  9.  
  10.     Copyright 1995, jonny bergdahl data AB - All rights deserved.
  11.     Modifications (C)1999 by Johan Zwiekhorst, 2:292/100
  12.  
  13.  
  14.   Disclaimer
  15.   ----------
  16.  
  17.     I guarantee that this program will take up some space on your hard
  18.     disk. That is all. If you decide to run it despite this very meager
  19.     warranty, however, standard software disclaimers apply. This means:
  20.     I don't guarantee anything concerning this software and so will not
  21.     be liable in any way for any damages incurred.
  22.  
  23.   SEE LICENCE.TXT FOR FURTHER INFORMATION!
  24.  
  25.  
  26.   Preface
  27.   -------
  28.  
  29.     When the original author of this program, Jonny Bergdahl, was the
  30.     Region 20 Coordinator (RC20) of Fidonet Zone 2, the need for this
  31.     program arose from all of the hubs and NCs which apparently just
  32.     couldn't get their act together and submit a correct nodelist segment,
  33.     for whatever reasons that was.
  34.  
  35.     This program, once installed, aids such inadequately functioning
  36.     coordinators to make sure that the submitted segments use no illegal
  37.     flags, no redundant modem flags and even tidies up the user flag field by
  38.     reformatting it. It is fully configurable so that new flags may be added
  39.     as they are approved. It can be used by anone from a hub submitting his
  40.     hub segment via NC and RC up to the ZC handling a multitude of segment
  41.     files, even in different networks.
  42.  
  43.   Installation
  44.   ------------
  45.  
  46.     The following files are necessary for the proper functioning of the
  47.     program; 
  48.  
  49.        ERRFLAGS.EXE   Main DOS executable
  50.        ERRFLAG2.EXE   Main OS/2 executable
  51.        ERRFLAGS.CTL   Main configuration file
  52.        ERRFLAGS.TAB   Approved flag setup file
  53.  
  54.     The following file is not necessary, and may be removed if not used;
  55.  
  56.        ERRFLAGS.CMT   Text file containing the header that gets copied
  57.                       to all reports and notifications.
  58.  
  59.     Copy these files to any directory of your choice, and edit the CTL
  60.     and CMT files to suit your needs. Insert execution of ERRFLAGS.EXE 
  61.     at the proper place in your mailer batch file, and you're ready to go.
  62.  
  63.  
  64.   Command line parameters
  65.   -----------------------
  66.  
  67.      ErrFlags accepts one command line parameter, and that is the name
  68.      of the configuration file. The default name is ERRFLAGS.CTL.
  69.      Overriding this makes it possible to use ErrFlags when coordinating 
  70.      several FTN type networks such as FDNet, IntlNet, ZyXELnet etc, 
  71.      where flag approval may differ from fidonet.
  72.  
  73.  
  74.   ERRFLAGS.CTL
  75.   ------------
  76.  
  77.     This is the configuration file that tells ErrFlags all it has to
  78.     know at run time. Fire up your favourite ASCII editor [no, WP is
  79.     not a proper ASCII editor :-)] and change the parameters based on
  80.     the comments in this file.
  81.     Note that all lines preceeded with the ";" character are ignored,
  82.     thus you will have to remove it for keywords you want to use.
  83.  
  84.  
  85.   ERRFLAGS.TAB
  86.   ------------
  87.  
  88.     This file defines the approved flags in Fidonet Zone 2 as of 15
  89.     July 2000. When new flags are approved, this is the file to edit.
  90.     Fire up your ASCII editor and change the flags according to the
  91.     comments in the file. You can always freq the latest file from
  92.     Z2C with the name 'ERRFLAGS.ZC2'.
  93.  
  94.  
  95.   ERRFLAGS.CMT
  96.   ------------
  97.  
  98.     This is just a simple ASCII file that gets copied as a header of all
  99.     notifications. Change this to suit your needs, and forget it. It might
  100.     also be used for informational purposes since effectively this text
  101.     is being sent to all your nodelist segment providers. If you have
  102.     something important to tell them, this might be a good place.
  103.  
  104.  
  105.   Source code
  106.   -----------
  107.  
  108.     If there is something in this program that you don't like you can
  109.     rewrite it, as I am distributing the full source code in the file 
  110.     ERRFLAGS.PAS. You will need a Borland Pascal compatible compiler,
  111.     and as I have used nothing very special, just about any old
  112.     version will work when compiling. However, if you do change the
  113.     program I would prefer if you would mail me a copy of the source
  114.     code. Write to Johan Zwiekhorst at 2:292/100@fidonet or
  115.     johanzw@mail.com via internet.
  116.  
  117.  
  118.   Revision history
  119.   ----------------
  120.     Version 2.0
  121.     -  Initial release.
  122.  
  123.     Version 2.1
  124.     -  Increased limit of nodelist segments to 80.
  125.     -  Added a NoTouch mode for those who don't want to fix other peoples
  126.        problems.
  127.  
  128.     Version 2.1.1
  129.     - Added ERRFLAG2.EXE, the OS/2 executable.
  130.  
  131.     Version 2.2
  132.     - Added check/removal of duplicate flags.
  133.  
  134.     Version 2.3
  135.     - Added support for wildcards in segment names.
  136.     - Added support for unarcing incoming segments.
  137.     - Changed behaviour of reports not to be posted when no errors found,
  138.       (Ward filled my inbound with reports of no errors :-) but this can
  139.       be forced anyway with the REPORTALL key word.
  140.     - Changed the appearance of the report to work with the Mickey Mouse
  141.       software "ROBO" that Ward is using.
  142.     - Removed the OS/2 executable, to speed up distribution. Please contact
  143.       Morten Mertner, 23/0 about availability of this.
  144.     - Added user flag ENC and redundancy pair V32T - V32B in ERRFLAGS.TAB
  145.  
  146.     Version 2.4
  147.     - Fixed bug concerning the inbound path.
  148.     - Fixed bug concerning reports not being sent to the right system.
  149.     - Added support for the NOERR keyword that defines what to execute
  150.       for error free segments.
  151.     - Removed support for the REPORTALL key word (which btw never worked
  152.       anyway) that has been obsoleted by the NOERR key word.
  153.  
  154.     Version 2.5
  155.     - Fixed bug concerning the inbound path with no-arc files
  156.     - Fixed problem with command line capitalizing
  157.  
  158.     Version 2.6
  159.     - Fixed handling of zone mail flags
  160.  
  161.     Version 2.7
  162.     - by Johan Zwiekhorst, 2:292/100. Since Jonny Bergdahl is no longer
  163.       in Fidonet, I'll take over.
  164.     - You can now use 200 user flags instead of 80, which was not enough
  165.       according to ZC2. The maximum length of one flag has been increased
  166.       from 15 to 32 characters.
  167.     - The previous wildcard '*' is now '?' in accordance with DOS: it means
  168.       substitute any one character.
  169.     - There is still a wildcard '*' and that is also in accordance with
  170.       DOS: it means any number of characters until end of line or end of
  171.       string, whatever comes first.
  172.     - Added the OS/2 executable again.
  173.  
  174.     Version 2.8
  175.     - Ben Baker's MAKENL can't handle nodelist entries of more than
  176.       157 characters, so ErrFlags now checks for that. Lines which
  177.       exceed 157 characters are shortened and a warning is issued.
  178.       ErrFlags will first strip characters from the system name, then
  179.       from the location and then from the flags section. The latter
  180.       action usually means that the last flag on the line could become
  181.       corrupted and therefore considered erroneous, which will lead to
  182.       another warning. An extra warning will be generated when
  183.       ErrFlags cuts characters from the flags section. ErrFlags will
  184.       always leave at least one character for the system name and the
  185.       location.
  186.     - All flag equality checks are now done case-insensitive.
  187.       This should simplify the TAB file construction.
  188.       Nodelist flags (except their parameters) are converted to uppercase.
  189.  
  190.