home *** CD-ROM | disk | FTP | other *** search
/ Boldly Go Collection / version40.iso / TS / 05B / REXCLD11.ZIP / REXCLUDE.DOC < prev    next >
Encoding:
Text File  |  1992-05-29  |  5.4 KB  |  153 lines
  1. ┌──────────────────────────────────────────────────────────────────────────┐
  2. │ REXCLUDE 1.1 Documentation                                   05/28/92    │
  3. └──────────────────────────────────────────────────────────────────────────┘
  4.  
  5.                  Copyright (c) 1992, Parsons Consulting
  6.  
  7.  
  8. WHAT IS IT?
  9. -----------
  10.  
  11.     REXCLUDE is a Robocomm User's Bonus utility.  As such, it is
  12.     available for use by any registered Robocomm user.  The purpose of
  13.     the program is to create a simple database of file names.  This
  14.     database, REXCLUDE.DBF, will be checked by Robocomm as it processes
  15.     new file lists.  Any file found in the database will automatiically
  16.     be excluded from the "New Files" directory in Robocomm.
  17.  
  18.  
  19. WHO NEEDS IT?
  20. -------------
  21.  
  22.     If you have a great deal of files on your system and don't want to
  23.     ever download a duplicate file, then REXCLUDE is just what the
  24.     doctor ordered.
  25.  
  26.     Although Robocomm has the ability to import a file listing of any
  27.     size into its "Downloaded Files" database, you may find that the
  28.     resulting database is too large to be easily managable.  REXCLUDE is
  29.     ideal if you want to keep your "Downloaded Files" directory
  30.     relatively small and still remove as many "duplicate" entries from
  31.     your "New Files" directory as possible.
  32.  
  33.     For Sysops, this program will allow you to inform Robocomm of all
  34.     the files available on your BBS without having to import your
  35.     ALLFILES list into the Downloads Directory.  After using REXCLUDE,
  36.     only files which are _not_ available on your BBS will show up on
  37.     Robocomm's new files list, allowing you to quickly select files to
  38.     be added to your system.
  39.  
  40.  
  41. USAGE
  42. -----
  43.  
  44.     Using REXCLUDE is extremely simple.  REXCLUDE is a command line
  45.     driven utility with the following syntax:
  46.  
  47.     REXCLUDE [-z] <Directory>|[PCB:]<File>
  48.  
  49.     All you do is specify a directory or file name on the command line
  50.     after typing REXCLUDE.  If you specify a directory name, then
  51.     REXCLUDE will scan the indicated directory for all files.  If you
  52.     specified a file, REXCLUDE will open it and process each line in the
  53.     file as a directory to be scanned for file names.
  54.  
  55. *** NEW IN VERSION 1.1 -- Rexclude will parse through a PCBoard format
  56.     dir file and add file names found in it to its databases.  To
  57.     process a PCB DIR file, just preface a file name with PCB:  For
  58.     example, to import a file called DIR01 into the database, you would
  59.     specify:
  60.  
  61.         REXCLUDE PCB:DIR01
  62.  
  63.     NOTE:  You may also add PCB:<file> entires to your list of
  64.            directories to scan.  See the example below.
  65.  
  66.  
  67.     -z is an optional switch which informs REXCLUDE to remove any
  68.     existing entiress in its database before processing.  You will only
  69.     need to use this switch if you have some reason to believe that
  70.     there is outdated data in the databases.
  71.  
  72.  
  73. A REAL WORLD EXAMPLE
  74. --------------------
  75.  
  76.     You are a sysop and you want to make sure theat no file on your system
  77.     ever shows up in Robocomm's "Available Files" list.  To do this,
  78.     simply create a file called REXCLUDE.LST and include the names of
  79.     all subdirectories on your system that contain downloadable files.
  80.     On Group One BBS, we use:
  81.  
  82.     C:\DIR01
  83.     C:\DIR02
  84.     C:\DIR03
  85.     C:\DIR04
  86.     C:\DIR05
  87.     C:\DIR06
  88.     PCB:E:\ROBOCOMM\PCBLOG.LST  <--- PCB dir format files can be listed too.
  89.     C:\DIR07
  90.     C:\UPLOADS
  91.     E:\PRIVATE
  92.     F:\DOWNLOAD
  93.     C:\TAPCIS
  94.  
  95.     In this example, DIR01-07 and C:\UPLOAD are the areas listed in the
  96.     DLPATH.LST file used by PCBoard, E:\PRIVATE is the private upload
  97.     area and both F:\DOWNLOAD and C:\TAPCIS\DOWNLOAD are directories
  98.     which may contain files download while online manually with other
  99.     comm programs (gasp!).
  100.  
  101.     To create a master database of all files available in these
  102.     directories, we simply type:
  103.  
  104.     REXCLUDE -z rexclude.lst
  105.  
  106.     Now, once the processing has completed we simply edit the nightly
  107.     event batch file to update the listing from any directories which
  108.     may have received new files during the day:
  109.  
  110.     REXCLUDE E:\PRIVATE
  111.     REXCLUDE F:\DOWNLOAD
  112.     REXCLUDE C:\UPLOADS
  113.     REXCLUDE C:\TAPCIS
  114.  
  115.  
  116.     NOTE:  The -z switch should not be used when updating an existing
  117.     REXCLUDE installation!  Also, You should do REXCLUDE updating
  118.     _before_ calling Robocomm. This will ensure that the REXCLUDE.DBF
  119.     file is as current as possible before Robocomm processes and new
  120.     files lists for the evening.
  121.  
  122.  
  123. SAVING OUTPUT
  124. -------------
  125.  
  126.     The output from REXCLUDE may be redirected to a file or the printer
  127.     by using the > redirection character on the command line.
  128.  
  129.     For example to append to an REXCLUDE.LOG file, you would type:
  130.  
  131.     REXCLUDE rexclude.lst >> rexclude.log
  132.  
  133.     To create a new log file every time rexclude is run, you would type:
  134.  
  135.     REXCLUDE rexclude.lst > rexclude.log
  136.  
  137.     NOTE:  If you do this, you will not see anything on the screen
  138.            during processing.
  139.  
  140.  
  141. HOW DO I KNOW IT'S WORKING?
  142. ---------------------------
  143.  
  144.     When Robocomm is processing new files lists (and your log type is
  145.     not set to BRIEF) you will see lines similar to the following in the
  146.     log window whenever Robocomm locates a file from REXCLUDE's database
  147.     in a BBS new files list:
  148.  
  149.     @ Excluded:     FOOBAR.ZIP
  150.  
  151.                                 < end of file >
  152.  
  153.