home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / UPCHECK / FBRAIN.ZIP / FBRAIN.DOC < prev    next >
Text File  |  1993-03-15  |  10KB  |  234 lines
  1.  
  2.                                  FILE BRAIN
  3.                       (C) Copyright 1993 by Stanley Sheff
  4.                         Support BBS: The Brainex System
  5.                                (310) 275-2344
  6.                                (310) 273-5234
  7.    
  8.  
  9.  
  10.  
  11.    File Brain is a replacement for the normal file testing routine used in
  12.    your BBS's upload routine.  Your BBS should be able to generate a data
  13.    file such as DOOR.SYS, and run a batch file after an upload. You will 
  14.    need at least 400K of RAM and DOS 3.3 or higher.
  15.    
  16.    This door requires the use of the Brainex Door Manager system.
  17.    if you have not installed the door manager, please do so before you
  18.    attempt to use this door.
  19.  
  20.    GAP BBS uses UPCHECK.BAT. Also, be sure to include a LOGON.BAT file
  21.    in your default (GAP) directory to generate a log on DOOR.SYS file.
  22.    When GAP sees this, it generates a DOOR.SYS file. There need not be
  23.    anything in this file other than @ECHO OFF.
  24.  
  25.    If your BBS does not create a DOOR.SYS or other door data file
  26.    when accepting an upload, you can use the DETECT option. File Brain
  27.    will read the current comport settings and attempt to use them.
  28.    You will need to experiment to see if the DETECT command will work
  29.    on your system.
  30.    
  31.    File Brain processes files with extenders of ZIP, LZH, ARJ, GIF, and ARC. 
  32.    
  33.    File Brain will do the following after an upload:
  34.  
  35.    o Check for Duplicate CDROM files (If you use Rombrain!)
  36.    o Test for CRC errors in the .ZIP file.
  37.    o Test for imbedded .ZIP files and if found, CRC check those too.
  38.    o Test for imbedded .TD0 (Teledisk) files and if found, test with TDCHECK.
  39.    o Virus SCAN imbedded EXE and COM files, using SCAN.EXE from McAffey.
  40.    o Remove all .ZIP comments from the file.
  41.    o Replace .ZIP comments with your own. (Optional)
  42.    o Delete unwanted BBS ads and/or other unwanted ZIP members as you define.
  43.    o Test .GIF files for validity if you accept that file format (Optional)
  44.    o Reject programs older than a date (year) which you specify.
  45.    o Extract FILE_ID.DIZ if present, format to 45 or 70(GAP) cols., 10 lines,
  46.      and add newest file date if FILE_ID.DIZ is under 10 lines in length.
  47.    o Extract DESC.SDI if present
  48.    o Use a RAMDISK for temporary files, increasing speed (Optional)
  49.                                                                         
  50.    Included is a file called UTILITY.ZIP, with the following files:
  51.  
  52.         PKZIP.EXE   - Phil Katz archive create program (version 2.04G)
  53.         PKUNZIP.EXE - Phil Katz archive extract program (version 2.04G)
  54.         PKPAK.EXE   - Archive Program from PKWARE   
  55.         PKUNPAK.EXE - Archive Program from PKWARE   
  56.         LHA.EXE     - Archive Program by Haruyasu Yoshizaki   
  57.         ARJ.EXE     - Archive Program by Robert K. Jung
  58.         TDCHECK.EXE - .TD0 (Teledisk) checker from SyDex (any version)
  59.         SCAN.EXE    - McAffey's virus detection program (any version)
  60.                       or a Virus Checker of your choice.  
  61.         RECOM.EXE   - Mike Loewen's ZIP file comment remover/date stamper.
  62.         GIFTEST     - Dave Navarro's .GIF file tester
  63.         TESTPRM.BAT - Displays passed BBS file parameters for testing.
  64.  
  65.    These files must be in your PATH, and may require registration for
  66.    continued use. PLEASE SUPPORT SHAREWARE AND DO SO!
  67.  
  68.     
  69.     File Brain Files
  70.     ----------------
  71.     FBRAIN.EXE    <------------------ File Brain Program
  72.     FBRAIN.DOC    <------------------ Sysop's Information
  73.     REGISTER.DOC  <------------------ Registration information
  74.     BBSADS        <------------------ Unwanted BBS Ad Files (Optional)
  75.     NOTEST        <------------------ Don't test these file extenders
  76.     UTILITY.ZIP   <------------------ Utilities need by File Brain
  77.     FILE_ID.DIZ   <------------------ Brief File Description
  78.  
  79.    Bad uploads will be reported to a file named ERRORS.RPT located
  80.    in your designated "JUNK" directory.
  81.    
  82.    All of these files should be in this ZIP, if they are not, don't
  83.    take a chance! Call The Brainex System and get a good copy or view the 
  84.    file on a few local boards to see if you can find a complete copy.
  85.  
  86.    The setup of File Brain is simple, all you need to do is unzip
  87.    FBRAIN.ZIP into a temporary directory, then type SETUP.
  88.    
  89.    The File Brain files will be copied to your BRAINEX directory.
  90.    The BRAINSET program will run, and you can answer the File Brain
  91.    set up questions. 
  92.  
  93.    Be sure to create a directory for virus infected files.
  94.  
  95.    File Brain returns a DOS exit errorlevel of 1 if the program detects
  96.    a bad upload.  Good uploads will return error level 0.  
  97.                      
  98.    To use File Brain, you will need to edit or create a batch file
  99.    that is run right after an upload. Such files are UPCHECK.BAT for GAP,
  100.    and PCBTEST.BAT for PCBoard. The basic command format is:
  101.  
  102.    FBRAIN  NODE=[node number]  FILE=[drive\path\filename] 
  103.    
  104.    FILENAME PARAMETER
  105.    ------------------
  106.    Use the FILE= command to tell File Brain the name of the file to check.
  107.  
  108.    FBRAIN FILE=%1
  109.  
  110.    %1 is the variable of the upload's DRIVE\PATH\FILENAME.EXT passed to
  111.    the batch file by the BBS after the upload. If you are unsure if your BBS
  112.    passes the complete filename to File Brain, you can use the included
  113.    TESTPRM.BAT file. Run this instead of your normal upload check batch
  114.    file.
  115.    
  116.    GAP BBS:
  117.    The name of the complete drive\path\filename of the file being tested will
  118.    passed as a parameter to the batch file as %1.
  119.  
  120.  
  121.    You can add a duplicate file check program, such as one that checks
  122.    files by CRC values.  Just run SETUP, then enter the name of the batch
  123.    file to the last option "DUPLICATE CHECKER Program."  If you do not
  124.    use this type of program, just enter NONE.  In the following example,
  125.    we have used the name CRC for the batch file.
  126.  
  127.  
  128.    REM EXAMPLE: CRC.BAT
  129.    REM CHANGE TO TESTER'S DRIVE
  130.    D:
  131.    REM CHANGE TO TESTER'S DIRECTORY
  132.    CD \CRCTEST
  133.    REM RUN THE TESTER WITH %1 AS THE PASSED DRIVE\PATH\FILENAME.EXT OF TEST FILE
  134.    CRCTEST %1
  135.  
  136.    For multinode systems, name the batch files CRC1.BAT for node 1, 
  137.    CRC2.BAT for node 2, etc. Place the batch files in the BRAINEX\FBRAIN 
  138.    directory. When setting up File Brain, you will be asked for the name of 
  139.    the duplicate checker batch file. Give the name without the node number
  140.    and .BAT extension, in this case CRC.  File Brain will add the node 
  141.    number and .BAT extension.
  142.    
  143.    
  144.    ROMBRAIN 
  145.    ========
  146.    If you use the Brainex Door ROMBRAIN, you can also check your CDROM
  147.    filebase for dupes. When using the door manager to sett up the door, 
  148.    you will be asked to indicate the cdrom numbers to check. Enter the
  149.    numbers separated by a comma, or 0 for no CDROM checks.
  150.     
  151.     
  152.     To remove unwanted BBS ads, create a text file named BBSADS, then put
  153.     a file name for each ad on a separate line. If this file is not present,
  154.     file Brain will not try to remove BBS ads.
  155.  
  156.     Edit the file NOTEST to add extenders of files you don't want tested.
  157.  
  158.     Once you have used BRAINSET to install the door, you can use a batch 
  159.     file to run the door. A batch file for a GAP BBS might look like this:
  160.    
  161.      ECHO OFF
  162.      CD \BRAINEX   
  163.      FBRAIN FILE=%1
  164.      
  165.    %1 is the variable of the upload's DRIVE\PATH\FILENAME.EXT passed to
  166.    the batch file by the BBS after the upload. On GAP BBS the batch file
  167.    is named UPCHECK.BAT.
  168.  
  169.    For multinode operation, add the node number to the command line:
  170.  
  171.    FBRAIN NODE=1 FILE=%1
  172.    or
  173.    FBRAIN NODE=2 FILE=%1
  174.    etc.
  175.  
  176.    PCBOARD BBS
  177.    ===========
  178.    To read the PCBOARD.SYS file, add the following command after FBRAIN:
  179.  
  180.    DATA=PCBOARD.SYS
  181.  
  182.    To update file description with FILE_ID.DIZ add:
  183.  
  184.    UPDESC=%3
  185.  
  186.    Example PCBTEST.BAT file:
  187.  
  188.    @ECHO OFF
  189.    FBRAIN DATA=PCBOARD.SYS NODE=1 FILE=%1 UPDESC=%3 
  190.  
  191.    LOCAL MODE
  192.    ==========
  193.    You can run File Brain from the DOS command line or a batch file
  194.    without a drop file (door.sys, dorinfo1.def, etc.) by using the 
  195.    LOCAL command. Example:
  196.  
  197.    FBRAIN LOCAL FILE=C:\TEST\TESTFILE.ZIP
  198.  
  199.    
  200.    DETECT MODE                        
  201.    -----------
  202.    Add DETECT to the command line, and File Brain will use the current
  203.    comport settings. Example:
  204.  
  205.    FBRAIN FILE=%1 DETECT
  206.    
  207.    This is useful for BBSes that do not create a door data file during 
  208.    an upload.
  209.  
  210.                            -*-     -*-     -*-
  211.  
  212.  
  213.    This version of File Brain is a DEMO. It is not crippled in any way,
  214.    but will only display your BBS NAME when registered. This door is 
  215.    released "As Is" and there is *NO* warranty or guarantee that it will 
  216.    work for you and not cause any problems. You have chosen to use this door, 
  217.    YOU are responsible for any unfortunate problems that may develop from 
  218.    its use or misuse. I will gladly listen to any suggestions or problems 
  219.    you may have, and I will do my best to fix whatever needs to be fixed. 
  220.    I can not be held responsible for any problems you may have, whether 
  221.    directly or indirectly due to the use of the door.
  222.    
  223.    Please read REGISTER.DOC for information on how you can register
  224.    your copy of File Brain. 
  225.    For complete support, contact PROFESSOR BRAINEX on The Brainex System.
  226.    Your questions will be quickly and cheerfully answered!
  227.  
  228.    Have Fun!
  229.    Stanley Sheff
  230.    The Brainex System
  231.    310-275-2344 HST
  232.    310-273-5234 V.32BIS/V,42BIS
  233.  
  234.