Beijing Paradise BBS Backup/PARADISE.ISO/software/BBSDOORW/RASCN202.ZIP/RASCAN.DOC

Text File | 1993-10-10 | 9.7 KB | 226 lines

                      RASCAN v2.02 DOCUMENTATION

                              10 OCT 1993

                           Current Features

   EASY setup.
   A NO friles online/offline upload processor. Just what everybody wants.
   Support for scanning program of your choice.
   Support for importing FILE_ID.DIZ or DESC.SDN/SDI into FDB (File Data Base).
   Support for batch file processing.
   Support for processing complete FDB or file area with one command.
   Support for upto 10 compression programs.
   Support for unpacking/scanning imbedded archives.
   Support for adding comments to archives.
   Will NOT communicate with uploader now or in the future.
   Will not expire for unregistered users. (Please register)
   Logging of information for later review. (Great feature IMHO)

                           Future Features

   Support for file ReArchiving.
   Will keep track of files already processed. (REGISTERED USERS ONLY)
   Some requested features that you ask for.

                              Comments

   RASCN200.ZIP was a complete rewrite of RASCN100.ZIP.

   A bug was discovered the day after release or version 2.00 and version 2.01
   was released about 2 days later. The improper setup of RASCAN unconvered a
   destructive bug in the code. When the set command was not correct and
   RASCAN could not find its' configuration file it would exit with an error
   and delete all files in the directory where it resided. This bug has been
   fixed but for you protection please place RASCAN in its' own directory. A
   bug was also discovered when DIZ was not included in the command line for
   RASCAN then the archives would not be unpacked. This bug is now fixed.

   With this release I hope to have corrected any bugs that could result in
   harm to your system so that I can continue developement of the program to
   just add needed functionality. I hope you like my idea of what an upload
   scanner should do.

   RASCAN will keep track of files that have already been processed for
   REGISTERED USERS ONLY.

   Any suggestions you may have please net mail me at 1:2320/190 or post in
   the RA_UTIL echo.

                                        Thanks,
                                        Dewayne


                                Setup

   1. Put all files into a directory of your choice. I recommend you create a
      directory for RASCAN alone however. For your saftey DO NOT place RASCAN
      in your RA directory. The program cleans up after itself and if setup
      incorrectly could delete files in the directory where it resides. I hope
      I have corrected this bug, but better to be safe.

   2. Set the enviroment for RASCAN by adding a SET command to your
      autoexec.bat file. Example ( SET RASCAN=C:\RASCAN ). Replace C:\RASCAN
      with the correct path to the directory where RASCAN can find all of its
      files. You MUST USE ALL CAPS FOR THE SET COMMAND. This has been the
      source of many setup errors and problems.

   3. Create a work directory for RASCAN. ALL files in this directory will be
      deleted when RASCAN is run. This directory should ALLWAYS be EMPTY.

   4. Edit RASCAN.CFG for your scanning program and other features. This file
      is very small and can be edited with any ascii editor. Case does not
      matter.

   5. Uses settings in RACONFIG. Enter the settings for your compression
      programs in RACONFIG. The extension MUST be included in the command line
      for the archivers to execute. Example: D:\util\pkzip -ao @ will NOT work.
      It MUST be D:\util\pkzip.exe -ao @ for the command line to execute.

   6. Command line for RASCAN in RACONFIG should be
      example ( C:\RASCAN\RASCAN.EXE @ ). Add *M to swap out RA. See below for
      additional options.

   7. That's all there is.


                          Configuration File

   1. The configuration file MUST be named RASCAN.CFG and located in the
      directory with RASCAN.EXE.

   2. KeyWords REQUIRED in configuration file:
      (a) "SCANNER" The word scanner must be in RASCAN.CFG. It must begin in
      column 1 followed by the commandline for your scanner. This is the only
      requirement for RASCAN.CFG.

      (b) "WORKDIR" followed by a space and the path.  THIS DIRECTORY SHOULD
          BE EMPTY OF FILES AT ALL TIMES. ALL FILES IN THIS DIRECTORY WILL BE
          DELETED WHEN RASCAN IS RUN. DO NOT HAVE THIS BE YOUR RA DIRECTORY.

      (c) "LOGFILE" followed by a space and the path. ONLY one allowed.

      (d) All other KeyWords are optional.

   3. KeyWords Optional in configuration file:
      (a) "COMMENT" followed by a space, the archive type, a space, command
          line for the compression program to add a comment. As many as you
          need to cover all compression programs that support comments in
          archives. Be sure to put the COMPLETE path for the compression
          program (including the extension) in the command line.

      (b) SEE INCLUDED RASCAN.CFG FILE FOR EXAMPLES. Edit this file to your
          needs. You should just need to change the paths and you will be ready
          to run with it.

                          CommandLine Examples

   1. RASCAN C:\RA\RA_200.ARJ DIZ CMT
      {this will unpack all files in RA_200.ARJ, scan files for virus, import
      FILE_ID.DIZ or DESC.SDI into FDB if one is present in archive, add
      comment to RA_200.ARJ.}

   2. RASCAN AREA 45 DIZ CMT
      {this will do the same as above but to all files in area 45 that are
      supported by your compression settings in RACONFIG.}

   3. C:\RASCAN\RASCAN.EXE @ DIZ *M
      {place this in RACONFIG to import FILE_ID.DIZ file and swap RA out}


                         Command Line requirements.

   1. The File or Area to be processed MUST be the FIRST parameter passed.
   2. To process an AREA the word "AREA" must be followed by a space and the
      area number to be processed. Putting a "0" after "AREA" will process the
      entire FDB.
   3. *M MUST the the last parameter if used.
   4. Additional switches can follow the filename or area and may be in any
      order.
   5. Case does not matter.



                        LICENCE AGREEMENT

   1.  This is a licence agreement between you, the end user, and
       Dewayne Cox. The RAScan v2.02 Shareware software
       and information attached hereto, hereafter "RAScan", is the
       property of Dewayne Cox. Read the terms and
       conditions of this licence agreement carefully before using
       the software. If you for any reason, whatsoever, cannot
       accept the conditions in this agreement, you are not
       permitted to use RAScan.

   2.  You acknowledge and agree that RAScan is a proprietary product
       of Dewayne Cox, protected by applicable copyright laws
       and international treaty provisions. You further acknowledge
       and agree that all rights, title, and interest in and to RAScan
       are and shall remain with Dewayne Cox.

   3.  RAScan may be used for a period of thirty (30) days on a trial
       basis to allow you to determine its suitability for your
       particular application. After this period you MUST register
       each copy of RAScan that you run simultaneously.

   4.  Registration entitles you to use RAScan and any future versions
       of RAScan for as long as you wish, subject to any special
       licensing conditions and/or applicable upgrade fees attached
       to future versions.

   5.  In the event that you are in violation of this licence
       agreement, you agree and accept that Dewayne Cox may
       cancel your registration and any rights to use RAScan that you
       may have. In the case of a dispute over the licence
       agreement, you further agree and accept to fully reimburse
       Dewayne Cox for legal and other expenses resulting
       from the dispute.

   6.  RAScan is provided "as is", without warranty of any kind or
       fitness for a particular purpose, either expressed or
       implied, all of are hereby explicitly disclaimed. Dewayne
       Cox only guarantees that FrontDoor will occupy disk space.

       Dewayne Cox's liability resulting from your use or
       inability to use RAScan is limited to the amount that the
       affected party has paid for it, or in the event that RAScan was
       registered with a third party for payment to Dewayne Cox,
       liability is limited to the amount that was received by
       Dewayne Cox from that third party.

   7.  Neither Dewayne Cox nor any of his employees,
       agents, or other representatives are in any way obligated to
       provide future versions of, or support for, RAScan.


   8.  You may freely distribute and copy RAScan provided that no
       fee is charged and the RAScan distribution archive contains
       unmodified copies of the original files as produced by Dewayne
       Cox. Pay Bulletin Board Systems may, however, charge
       their normal fee provided that no additional charge for RAScan
       is levied. No part of RAScan may be modified, altered, reverse
       engineered, sold, or distributed in any form whatsoever which
       would involve some sort of trade without prior written
       permission from Dewayne Cox.

   9.  RAScan may not be used in any unlawful or illegal manner.


   10. Sunny Side BBS is the official support site for RAScan.
       All  future versions  of RAScan  will be  available on Sunny
       Side BBS.

       RAScan may be requested by using  the magic name RASCAN or you
       may log onto the BBS and download the latest version.

       Sunny Side BBS
       1:2320/190
       BBS:  [phone]
       PO Box 1292
       New Albany, IN 47151-1292