home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / ADDTY100.ZIP / ADDTODAY.DOC next >
Encoding:
Text File  |  1995-04-05  |  6.3 KB  |  121 lines
  1.  
  2.  
  3.    ADDTODAY v1.00                 ADDTODAY.DOC                       04/05/95
  4.  
  5.  
  6.    NOTE:  Enter COPY ADDTODAY.DOC PRN to print this file.  It is formatted to
  7.           print 2 pages with approximately 60 lines per page.
  8.  
  9.  
  10.    CAUTION:  ADDTODAY performs a self-test for viruses and/or tampering on
  11.    startup to insure that you have an unaltered program.  You cannot use an
  12.    executable file compressor such as PKLITE on ADDTODAY or it will fail its
  13.    self-check and overwrite itself.
  14.  
  15.  
  16.    SYSOPS!
  17.  
  18.    This utility will hopefully make managing your BBS a little less time
  19.    consuming.  It was written at the request of the same PCBoard sysop that
  20.    suggested the development of MERGEPRO/MERGESYS.  He uses a concept he
  21.    calls "shovelware", which translated means he gets files from satellite,
  22.    fidonet, internet, other BBS's, ... "shovels" them all into a directory to
  23.    extract their file descriptions, then "uploads" them to his BBS.  ADDTODAY
  24.    helps automate this process (see PRODUCTS.DOC for related programs).  It
  25.    works on ASCII text file descriptions in both WildCat! or PCBoard format,
  26.    but should also work on one-line descriptions, or multi-line if either an
  27.    empty line separates each description or the first line starts at the left
  28.    margin and any continuing lines contain the "pipe" character (it cannot be
  29.    on the first) or begin with a "space".  Lines can be up to 255 characters.
  30.  
  31.    Suppose you have a list of file descriptions that are ready to be added to
  32.    your main upload directory.  Instead of adding them all at once, ADDTODAY
  33.    can be run each day (e.g., from a batch file) on the new file description
  34.    list and add those whose "day of month" number matches the current system
  35.    day (e.g., the file description date is 08-30-93 and the system date is
  36.    11-30-94).  When ADDTODAY appends the descriptions, it also changes the
  37.    description date to the current date (e.g., 11-30-94).  As far as callers
  38.    to your BBS are concerned, they see a bunch of new files every day.  The
  39.    default file description date starting column is 24, which can be changed.
  40.  
  41.    You can set both a minimum and maximum number of descriptions to be added
  42.    if desired (setting the minimum and maximum to the same value will add a
  43.    fixed number each day).  ADDTODAY can also execute an optional batch file
  44.    with each file name whose description has been added, such as moving the
  45.    parent file to your uploads directory.  As descriptions are added, they
  46.    are removed from the new files list and when it is empty, you are notified
  47.    with a message to replace it (the message goes both to the screen and is
  48.    written to the empty new files list.  WildCat! BBS's can still use this
  49.    technique, but with an extra step.  Today's descriptions could be written
  50.    to a new text file each day, which is then converted to the database
  51.    format and inserted into the existing file list database.  The work files
  52.    should be deleted afterwards in preparation for the next day's run.
  53.  
  54.    Entering ADDTODAY without any parameters accesses "help", which describes
  55.    the syntax and commands.  Since this utility is designed to run unattended
  56.    from a batch file, it quits with an errorlevel that can be tested.  For a
  57.    list of the various exit codes, please see the help system.  Its screen
  58.    output can also be redirected to create a log by using the "greater than"
  59.    symbol, e.g., ADDTODAY addlist uploads > addtoday.log.  Using ">>" will
  60.    append each day's log rather than overwriting the previous day's.
  61.  
  62.  
  63.  
  64.                              DISCLAIMER OF WARRANTY
  65.  
  66.        THIS SOFTWARE AND DOCUMENTATION ARE PROVIDED "AS IS", WITHOUT
  67.        WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT
  68.        NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
  69.        FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS TO THE
  70.        RESULTS AND PERFORMANCE OF THIS SOFTWARE IS ASSUMED BY THE USER.
  71.        IN NO EVENT WILL THE AUTHOR OF THIS SOFTWARE, OR ANYONE ELSE WHO
  72.        HAS BEEN INVOLVED IN ITS CREATION, PRODUCTION, OR DELIVERY, BE
  73.        LIABLE TO YOU OR ANY OTHER PARTY FOR ANY DIRECT, INDIRECT,
  74.        INCIDENTAL, OR CONSEQUENTIAL DAMAGES (INCLUDING DAMAGES FOR LOSS
  75.        OF BUSINESS PROFITS, INFORMATION, AND THE LIKE) RESULTING FROM ANY
  76.        DEFECT IN THIS SOFTWARE OR DOCUMENTATION OR ARISING FROM THE USE
  77.        OF OR INABILITY TO USE THIS SOFTWARE OR DOCUMENTATION EVEN IF THE
  78.        AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  79.  
  80.        BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS INTO
  81.        WHICH THIS PROGRAM MAY BE PLACED, IT SHOULD ALWAYS BE THOROUGHLY
  82.        TESTED WITH NONCRITICAL DATA BEFORE RELYING ON IT.  YOUR USE OF
  83.        THIS SOFTWARE INDICATES THAT YOU HAVE READ AND AGREED TO THESE AND
  84.        ANY OTHER TERMS INCLUDED IN THIS SOFTWARE COLLECTION.  SOME STATES
  85.        DO NOT ALLOW THE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES OR
  86.        LIABILITIES FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE
  87.        LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU.
  88.  
  89.  
  90.    Live long and prosper.
  91.  
  92.  
  93.    PCBoard is a registered trademark of Clark Development Company, Inc.
  94.    PKLITE is a registered trademark of PKWARE, Inc.
  95.    WildCat! is a trademark of Mustang Software, Inc.
  96.  
  97.  
  98.    You may contact me at any of the addresses given below.
  99.  
  100.    Write to:  Hal Parks                  E-Mail:  8:970/201           RBBSNet
  101.               HAL SoftWare                        1:11/157            FIDONet
  102.               404B W. Oak                                   InterNet
  103.               Carbondale, IL 62901                charlies@skelos.lib.siu.edu
  104.  
  105.    OR leave a message for me with InfoQuest BBS at 618-529-0000
  106.    OR through InfoQuest's sysop (safest bet for E-Mail and messages)
  107.  
  108.             InterNet:  charlies@skelos.lib.siu.edu
  109.             RBBSNet:   8:970/201       FIDONet:  1:11/157
  110.                             USERNAME:  Charles Strusz
  111.             FIDO NODELIST CORRECTION:  Phone should be 618.529.0000
  112.  
  113.  
  114.    The latest version can always be downloaded by calling:
  115.  
  116.    InfoQuest BBS, Carbondale, IL, 618-529-0000 (sign on as a GUEST USER and
  117.                                                    join the HAL conference)
  118.    Shawnee Free-Net BBS, Carbondale, IL, 618-549-8448
  119.    Rusty-n-Edie's BBS, Youngstown, OH, 216-726-2620
  120.  
  121.