home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 6 / The_Pier_Shareware_Number_6_(The_Pier_Exchange)_(1995).iso / 004 / fbrain.zip / FBRAIN.DOC < prev    next >
Text File  |  1994-06-14  |  11KB  |  269 lines
  1.  
  2.                                  FILE BRAIN
  3.                       (C) Copyright 1994 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.    You may also need the file called FUTILS.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.         SHROOM.ZIP  - Shell Memory Shrinker (useful with SCAN and low RAM)
  65.  
  66.    These files must be in your PATH, and may require registration for
  67.    continued use. PLEASE SUPPORT SHAREWARE AND DO SO!
  68.  
  69.    FUTILS.ZIP is available for download from The Brainex System.
  70.     
  71.     File Brain Files
  72.     ----------------
  73.     FBRAIN.EXE    <------------------ File Brain Program
  74.     FBRAIN.DOC    <------------------ Sysop's Information
  75.     REGISTER.DOC  <------------------ Registration information
  76.     BBSADS        <------------------ Unwanted BBS Ad Files (Optional)
  77.     NOTEST        <------------------ Don't test these file extenders
  78.     FILE_ID.DIZ   <------------------ Brief File Description
  79.  
  80.    Bad uploads will be reported to a file named ERRORS.RPT located
  81.    in your designated "JUNK" directory.
  82.    
  83.    All of these files should be in this ZIP, if they are not, don't
  84.    take a chance! Call The Brainex System and get a good copy or view the 
  85.    file on a few local boards to see if you can find a complete copy.
  86.  
  87.    *******************************************************************
  88.    File Brain requires external programs such as PKZIP and GIFTEST.
  89.    
  90.    Please download FUTILS.ZIP from the Brainex System for all the
  91.    utilities required by File Brain.
  92.  
  93.    You will also need a current copy of SCAN.EXE for virus checking,
  94.    also available on The Brainex System: 310-275-2344 or 310-273-5234
  95.    *******************************************************************
  96.  
  97.    The setup of File Brain is simple, all you need to do is unzip
  98.    FBRAIN.ZIP into a temporary directory, then type SETUP.
  99.    
  100.    The File Brain files will be copied to your BRAINEX directory.
  101.    The BRAINSET program will run, and you can answer the File Brain
  102.    set up questions. 
  103.  
  104.    Be sure to create a directory for virus infected files.
  105.  
  106.    File Brain returns a DOS exit errorlevel of 1 if the program detects
  107.    a bad upload.  Good uploads will return error level 0.  
  108.                      
  109.    To use File Brain, you will need to edit or create a batch file
  110.    that is run right after an upload. Such files are UPCHECK.BAT for GAP,
  111.    and PCBTEST.BAT for PCBoard. The basic command format is:
  112.  
  113.    FBRAIN  NODE=[node number]  FILE=[drive\path\filename] 
  114.    
  115.    FILENAME PARAMETER
  116.    ------------------
  117.    Use the FILE= command to tell File Brain the name of the file to check.
  118.  
  119.    FBRAIN FILE=%1
  120.  
  121.    %1 is the variable of the upload's DRIVE\PATH\FILENAME.EXT passed to
  122.    the batch file by the BBS after the upload. If you are unsure if your BBS
  123.    passes the complete filename to File Brain, you can use the included
  124.    TESTPRM.BAT file. Run this instead of your normal upload check batch
  125.    file.
  126.    
  127.    REMOTEACCESS BBS:
  128.    Using RACONFIG, select Options > Files > Upload scan 
  129.    Edit the options as follows:
  130.  
  131.    Scan online  Yes
  132.    Failed scan  /unavailable
  133.    Scan utility C:\BRAINEX\FBRAIN.EXE NODE=*N FILE=@ *! *M
  134.    
  135.    When using FBRAIN in local mode, select the file area to check
  136.    using the AREA= command.
  137.  
  138.    FBRAIN NODE=1 AREA=10 FILE=TEST.ZIP
  139.  
  140.  
  141.  
  142.    GAP BBS:
  143.    The name of the complete drive\path\filename of the file being tested will
  144.    passed as a parameter to the batch file as %1.
  145.  
  146.  
  147.    You can add a duplicate file check program, such as one that checks
  148.    files by CRC values.  Just run SETUP, then enter the name of the batch
  149.    file to the last option "DUPLICATE CHECKER Program."  If you do not
  150.    use this type of program, just enter NONE.  In the following example,
  151.    we have used the name CRC for the batch file.
  152.  
  153.  
  154.    REM EXAMPLE: CRC.BAT
  155.    REM CHANGE TO TESTER'S DRIVE
  156.    D:
  157.    REM CHANGE TO TESTER'S DIRECTORY
  158.    CD \CRCTEST
  159.    REM RUN THE TESTER WITH %1 AS THE PASSED DRIVE\PATH\FILENAME.EXT OF TEST FILE
  160.    CRCTEST %1
  161.  
  162.    For multinode systems, name the batch files CRC1.BAT for node 1, 
  163.    CRC2.BAT for node 2, etc. Place the batch files in the BRAINEX\FBRAIN 
  164.    directory. When setting up File Brain, you will be asked for the name of 
  165.    the duplicate checker batch file. Give the name without the node number
  166.    and .BAT extension, in this case CRC.  File Brain will add the node 
  167.    number and .BAT extension.
  168.    
  169.    
  170.    ROMBRAIN 
  171.    ========
  172.    If you use the Brainex Door ROMBRAIN, you can also check your CDROM
  173.    filebase for dupes. When using the door manager to sett up the door, 
  174.    you will be asked to indicate the cdrom numbers to check. Enter the
  175.    numbers separated by a comma, or 0 for no CDROM checks.
  176.     
  177.     
  178.     To remove unwanted BBS ads, create a text file named BBSADS, then put
  179.     a file name for each ad on a separate line. If this file is not present,
  180.     file Brain will not try to remove BBS ads.
  181.  
  182.     Edit the file NOTEST to add extenders of files you don't want tested.
  183.  
  184.     Once you have used BRAINSET to install the door, you can use a batch 
  185.     file to run the door. A batch file for a GAP BBS might look like this:
  186.    
  187.      ECHO OFF
  188.      CD \BRAINEX   
  189.      FBRAIN FILE=%1
  190.      
  191.    %1 is the variable of the upload's DRIVE\PATH\FILENAME.EXT passed to
  192.    the batch file by the BBS after the upload. On GAP BBS the batch file
  193.    is named UPCHECK.BAT.
  194.  
  195.    For multinode operation, add the node number to the command line:
  196.  
  197.    FBRAIN NODE=1 FILE=%1
  198.    or
  199.    FBRAIN NODE=2 FILE=%1
  200.    etc.
  201.  
  202.    PCBOARD BBS
  203.    ===========
  204.    To read the PCBOARD.SYS file, add the following command after FBRAIN:
  205.  
  206.    DATA=PCBOARD.SYS
  207.  
  208.    To update file description with FILE_ID.DIZ add:
  209.  
  210.    UPDESC=%3
  211.  
  212.    Example PCBTEST.BAT file (single node):
  213.  
  214.    @ECHO OFF
  215.    FBRAIN DATA=PCBOARD.SYS NODE=1 FILE=%1 UPDESC=%3 
  216.  
  217.    Example PCBTEST.BAT file for node 1 (multi-node):
  218.  
  219.    @ECHO OFF
  220.    CD \%PCBNODE%
  221.    FBRAIN DATA=PCBOARD.SYS NODE=1 FILE=%1 UPDESC=%3 
  222.    %PCBDRIVE%
  223.    CD \%PCBDIR%
  224.  
  225.  
  226.    LOCAL MODE
  227.    ==========
  228.    You can run File Brain from the DOS command line or a batch file
  229.    without a drop file (door.sys, dorinfo1.def, etc.) by using the 
  230.    LOCAL command. Example:
  231.  
  232.    FBRAIN LOCAL FILE=C:\TEST\TESTFILE.ZIP
  233.  
  234.    
  235.    DETECT MODE                        
  236.    -----------
  237.    Add DETECT to the command line, and File Brain will use the current
  238.    comport settings. Example:
  239.  
  240.    FBRAIN FILE=%1 DETECT
  241.    
  242.    This is useful for BBSes that do not create a door data file during 
  243.    an upload.
  244.  
  245.                            -*-     -*-     -*-
  246.  
  247.  
  248.    This version of File Brain is a DEMO. It is not crippled in any way,
  249.    but will only display your BBS NAME when registered. This door is 
  250.    released "As Is" and there is *NO* warranty or guarantee that it will 
  251.    work for you and not cause any problems. You have chosen to use this door, 
  252.    YOU are responsible for any unfortunate problems that may develop from 
  253.    its use or misuse. I will gladly listen to any suggestions or problems 
  254.    you may have, and I will do my best to fix whatever needs to be fixed. 
  255.    I can not be held responsible for any problems you may have, whether 
  256.    directly or indirectly due to the use of the door.
  257.    
  258.    Please read REGISTER.DOC for information on how you can register
  259.    your copy of File Brain. 
  260.    For complete support, contact PROFESSOR BRAINEX on The Brainex System.
  261.    Your questions will be quickly and cheerfully answered!
  262.  
  263.    Have Fun!
  264.    Stanley Sheff
  265.    The Brainex System
  266.    310-275-2344 HST
  267.    310-273-5234 V.32BIS/V,42BIS
  268.  
  269.