home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / extr_net.zip / EXTR_NET.DOC < prev    next >
Text File  |  1994-05-29  |  6KB  |  139 lines
  1.  
  2.                                   EXTR_NET
  3.                                 Version 2.20
  4.             Copyright (c) Bob Swift, 1988-94.  All Rights Reserved.
  5.                    Compiled with the Borland C++ compiler.
  6.  
  7.    This program is designed to read an input nodelist file and extract
  8.    selected Networks, Regions and/or Zones.  The extracted portions of
  9.    the nodelist are stored in a file specified on the command line.
  10.  
  11.    The format for using this program is as follows:
  12.  
  13.  
  14.         EXTR_NET <srcfile> <destfile> [I] <net1> <net2>...<net20>
  15.  
  16.    where <srcfile>    is the name of the nodelist file to be read
  17.          <destfile>   is the name of the output file created
  18.          [I]          optionally include all Zone entries
  19.          <net..>      are the numbers of the Net/Region/Zones to be extracted
  20.                       and may include zone specifiers for Nets and Regions
  21.                       (the program is presently set to handle 20 numbers).
  22.                       These numbers may be preceded by a N, R or Z in order
  23.                       to extract the entire Net, Region or Zone.  Examples
  24.                       are: 123 N342 n2:201 r17 Z1
  25.  
  26.  
  27.    The nodelist may be specified with a full drive and path.  The destination
  28.    file must not have a drive or path specified.  It will be output to the
  29.    current directory.
  30.  
  31.    The inclusion of Zone lines is controlled in two ways and they operate
  32.    differently.  The first way is to use the optional 'I' parameter, which
  33.    will include all Zone lines in the nodelist.  The other way is to use a
  34.    zone-specifier with the search criteria.  This will only include those
  35.    Zone lines which are specified in the search criteria.  For example, if
  36.    your command line looks like this:
  37.  
  38.         extr_net nodelist.123 net-342.123 i n342
  39.  
  40.    the output would include all Zone listings as well as all of the entries
  41.    in Net 342 in every zone where Net 342 appears.  If the command line is
  42.    modified as:
  43.  
  44.         extr_net nodelist.123 net-342.123 n342
  45.  
  46.    the output would not include any Zone listings but would include all of
  47.    the entries in Net 342 in every zone where Net 342 appears.  If the
  48.    command line is further modified as:
  49.  
  50.         extr_net nodelist.123 net-342.123 n1:342
  51.  
  52.    the output would not include any Zone listings except Zone 1, and would
  53.    include all of the entries for Net 342 in Zone 1.  Note that use of the
  54.    'I' parameter will always result in the inclusion of all Zone lines.
  55.  
  56.    The program will display a VERY brief set of instructions if it is called
  57.    without any arguments or if it encounters an error.  The following is a
  58.    list of the error codes returned by the program:
  59.  
  60.                   0 - No errors.  Normal termination.
  61.                   1 - Bad or missing command line argument.
  62.                   2 - Unable to open the input file.
  63.                   3 - Unable to open the output file.
  64.                   4 - Problem writing to output file.
  65.                   5 - Problem closing input file.
  66.                   6 - Problem closing output file.
  67.                   7 - Unable to open configuration file.
  68.                   8 - Unable to create backup file.
  69.  
  70.    When an error is encountered, the program will exit immediately and will
  71.    attempt to properly close all files.
  72.  
  73.    Although I have chosen to retain all rights to this program, you are free
  74.    to use it under the following conditions:
  75.  
  76.             - You realize that there is NO Warrantee of any sort.
  77.               It was tested pretty thoroughly here before release
  78.               but who knows what bugs may be lurking within.
  79.  
  80.             - You will not modify the code and release a new version
  81.               of the program.  I welcome suggestions for improvement
  82.               (especially when accompanied by code) but I make no
  83.               guarantee of future releases.
  84.  
  85.             - If you find the program useful, I ask that you do
  86.               something to brighten somebody else's day.  Just
  87.               exactly what, I will leave up to you.
  88.  
  89.  
  90.    You may freely distribute this program provided that you distribute only
  91.    the complete archive which includes the EXTR_NET.EXE, EXTR_NET.C and
  92.    EXTR_NET.DOC.  In addition, You MUST NOT charge for the program nor can
  93.    you charge a copy fee over $4.00 (including the price of the diskette).
  94.  
  95.  
  96.                                                    Bob Swift (1:342/5)
  97.  
  98.  
  99.     Revision History
  100.     ----------------
  101.  
  102.     1.00    88/11/08    First release version.
  103.  
  104.     1.01    88/11/08    Correct a minor problem with file names and the
  105.                         creation of the output backup file.
  106.  
  107.     1.10    88/11/09    Finally corrected the null pointer and backup bug
  108.                         for good this time.  Someday I will learn to handle
  109.                         strings properly <grin>.  Also cleaned up the error
  110.                         code handling section so that the error messages
  111.                         make sense and included comment lines in output
  112.                         file to show what input file was used and to
  113.                         separate each extracted Net/Region.
  114.  
  115.     2.00    89/05/07    Modified command line inputs slightly to allow
  116.                         extraction of entire Net, Region or Zone by specifying
  117.                         N, R or Z with the number.  Numbers entered with no
  118.                         specifier will be matched to anything but will only
  119.                         extract until the next occurence of a Host, Region or
  120.                         Zone statement.  Also echoed the search criteria to
  121.                         the output file.
  122.  
  123.     2.01    91/12/28    Cleaned up comments in output file.
  124.  
  125.     2.02    93/09/12    Updated the FidoNet address in the documentation.
  126.  
  127.     2.10    93/09/26    Added option to include all Zone entries.  Also
  128.                         added option of zone-specific Net and Region
  129.                         searches due to there being duplicate Net and
  130.                         Region numbers in different Zones.
  131.  
  132.     2.11    93/09/26    Cleaned up error exit screen.
  133.  
  134.     2.12    93/11/14    Added date and time stamping in output file at the
  135.                         request of Tom Hall (NC342).
  136.  
  137.     2.20    94/05/29    Now puts the correct CRC value in the first line.
  138.  
  139.