home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_opus / adump100.arj / AREADUMP.DOC < prev   
Text File  |  1991-06-20  |  3KB  |  83 lines
  1.  
  2.                               AreaDump v1.00
  3.                    Copyright (C) 1991 by George Hatchew
  4.                            All Rights Reserved.
  5.  
  6.  
  7.   AreaDump is a simple, small, fast program that will "look into" your
  8.   Opus-CBCS v1.20 SYSMSG.DAT file and compile a generic AREAS.BBS file.
  9.   AreaDump is completely free to use, as long as you are running Opus-CBCS
  10.   v1.20 or its compatible updates.  Any other software requires a fee of
  11.   $500 to the author.  (Send Netmail to FidoNet address below for complete
  12.   licensing information). :-)
  13.  
  14.   In order to operate, AREADUMP.COM must be able to locate your BBS.PRM
  15.   file.  From your BBS.PRM file, AreaDump finds everything it needs to
  16.   know.
  17.  
  18.   AreaDump finds your BBS.PRM file through the following steps:
  19.   1)  If you have SET the environment variable OPUS=<bbs.prm name>
  20.       AreaDump will use that.  If you have "SET OPUS=C:\OPUS\BBS",
  21.       AreaDump will add the ".PRM" onto the path.
  22.  
  23.   2)  If it cannot find the OPUS environment variable, AreaDump will
  24.       default to using "BBS.PRM" in the current directory.
  25.  
  26.   3)  If you want to override these, specify the BBS.PRM name to use on
  27.       the command line.  (To use LINE2.PRM, simply type "AreaDump LINE2" on
  28.       the command line.)
  29.  
  30.  
  31.   In order to do away with YADCF <Yet Another Dreaded Config File>,
  32.   AreaDump's list goes to the Standard Output Device.  You can send it to
  33.   your printer, to a disk file, or wherever.  Without using DOS's
  34.   redirection, the output goes to your console.
  35.  
  36.   Example Usage:
  37.      AREADUMP BBS  > C:\QM\AREAS.BBS     <- Sends output to Disk File
  38.      AREADUMP OPUS > PRN                 <- Sends output to your Printer
  39.      AREADUMP > NUL                      <- Sends output to The Bit Bucket
  40.  
  41.   AreaDump will find your system name and sysop name from the .PRM file it
  42.   uses.  (For the "Intro" line of the AREAS.BBS file.)
  43.  
  44.   AreaDump also accepts two command line parameters:
  45.  
  46.   -Z#    To ONLY output Echos that are in a particular Zone, use the -Z
  47.          command line.
  48.  
  49.          Example:  AreaDump -z69
  50.  
  51.          Would compile a list of only the areas that you are
  52.          sending/receiving from Zone 69.  The default behavior is to list
  53.          ALL Echomail areas, regardless of zone information.
  54.  
  55.   -L     Tells AreaDump to list Zone numbers into your AREAS.BBS file.
  56.          By default, AreaDump will not include the zone in its output
  57.          list.
  58.  
  59.  
  60.   Examples:
  61.   AREADUMP C:\OPUS\BBS.PRM -L -Z1 > AREAS.BBS
  62.   [Loads BBS.PRM in your OPUS directory, and only outputs Zone 1 Echo Areas]
  63.   Output:
  64.   C:\OPUS\MSGS\FIDO\MEADOW         MEADOW           1:2240/1 1:2240/172
  65.  
  66.   AREADUMP -Z69 > AREAS.69
  67.   [Loads BBS.PRM from Environment Var OPUS, and outputs only Zone 69 Areas]
  68.   Output:
  69.   C:\OPUS\MSGS\KINK\DIRTY          DIRTY            1300/72 4201/76
  70.  
  71.  
  72.   Hopefully that covers about everything.  What is it good for you ask?
  73.   I dunno... You decide!  I use it in my nightly maintenance so that I
  74.   always have a fresh AREAS.BBS lying around for programs like REPLYLNK
  75.   to use.  I'm sure others will find other useful applications.  If
  76.   nothing else, it'll take up just over 10K of your precious disk space.
  77.  
  78.   If you have problems, suggestions, complaints, or whatever, send them
  79.   to me (George Hatchew) at FidoNet address 1:2240/176.  I'll try to help
  80.   out with anything that I can.
  81.  
  82.   George
  83.