home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / SCANV_1A.ZIP / SCANVERT.DOC < prev    next >
Encoding:
Text File  |  1993-04-23  |  7.1 KB  |  144 lines
  1.                              Sysop Information for
  2.                                   SCANVERT.EXE
  3.  
  4.  
  5.     Legal Stuff:
  6.  
  7.         I have no interest in making a buck for something that I did more to
  8.     practice my Turbo Pascal programming (it's been years since I have done
  9.     any TP programs), than anything else. So while I keep the source codes and
  10.     the rights to this software, the executable file is released to the public
  11.     domain. In no event shall I be held responsible for any loses or damages
  12.     resulting from the use of this utility. It works at various test sites, and
  13.     if you have doubts then you should not use it.
  14.  
  15.     History:
  16.  
  17.         This utility was done at the request of a few RA sysops that complained
  18.     that there was not a decent archive converter for RA 2.00's Scan set up
  19.     line. So I undertook the task of creating this little program. While RA can
  20.     unarc and scan uploads on it's own and tell you if the archive is good, by
  21.     checking the returned errorlevels, it can not convert the files to a
  22.     different archive type, hence this utility comes in.
  23.  
  24.     Setup:
  25.  
  26.         In RACONFIG, under OPTION|FILES|UPLOAD SCAN enter the following on the
  27.     command line for the scan utility:
  28.  
  29.         c:\ra\scanvert.exe @ ARJ *M
  30.  
  31.     The path must be edited to reflect the actual location of your copy of
  32.     SCANVERT.EXE, and it can reside anywhere you wish. The '@' is translated by
  33.     RA to the full path and filename of the file to process. The ARJ could be
  34.     also ZIP,LZH,PAK,ARC,ZOO,HYP or SQZ and it denotes what type of archive you
  35.     want the upload converted to. If you leave this blank or enter any other
  36.     word not shown above, it will not perform any convertion. The *M is
  37.     EXTREMELY IMPORTANT!, as SCAN.EXE and some archivers use lots of memory and
  38.     problems including lost files could show up if you forget to swap RA out of
  39.     memory.
  40.  
  41.     You must also set RA to take proper action if a file fails. SCANVERT will
  42.     not move or delete any files that fail. RA must take care of that. If you
  43.     set RA to move the files and neglect to make that area you set in there, RA
  44.     will try to move them and delete them instead.
  45.  
  46.     Stuff:
  47.  
  48.         Scanvert operates along the following lines:
  49.  
  50.            1.- Upon startup, it looks for the EXITINFO.BBS and DORINFO1.DEF
  51.                in the current directory. If any of them is missing, it will
  52.                abort. If both files are found, it retrieves system info from
  53.                them.
  54.  
  55.            2.- CONFIG.RA is read to determine system paths and general info
  56.  
  57.            3.- A determination is made as to wether this is a real, remote
  58.                caller or a local test and the FOSSIL driver is initialized
  59.                if necessay.
  60.  
  61.            4.- The command line is processed for the path of the line to handle
  62.                and the archive type to convert to.
  63.  
  64.            5.- The target filename is processed to determine the path and be
  65.                able to search the FILES.RA for area info. Once the upload area
  66.                is found, the number is kept in memory for future reference.
  67.  
  68.            6.- The original archive type is determined and the proper archiver
  69.                is searched in the path. The archiver default command lines are
  70.                hardcoded, but that may change in future versions of this
  71.                program. The following archivers are used:
  72.  
  73.                         Extension               Archiver(s)
  74.                          ARC                    PKPAK.EXE, PKUNPAK.EXE
  75.                          ARJ                    ARJ.EXE
  76.                          ZIP                    PKZIP.EXE, PKUNZIP.EXE
  77.                          LZH                    LHA.EXE
  78.                          ZOO                    ZOO.EXE
  79.                          PAK                    PAK.EXE
  80.                          SDN                    PAK.EXE
  81.                          SQZ                    SQZ.EXE
  82.                          HYP                    HYPER.EXE
  83.                          DWC                    DWC.EXE
  84.  
  85.                The latest version of all this programs are set up in the
  86.                hardcoded list. I can not guarantee SCANVERT will work with
  87.                older versions of these archivers. All programs must reside
  88.                somewhere in the path. The current directory is NOT searched for
  89.                programs.
  90.  
  91.                In addition for GIF files only, GIFTEST.EXE by Dave Navarro will
  92.                be used, if found, to test the files. If an error is found in
  93.                the gif file, a non zero errorlevel is returned.
  94.  
  95.            7.- SCANVERT will swap itself to EMS if available or disk if EMS is
  96.                not available, in order to give the archiver as much memory to
  97.                work in as possible. If neither EMS or enough disk space is
  98.                available the scanvert will abort.
  99.  
  100.            8.- SCANVERT will create a temporary directory under the current
  101.                directory and decompress the archive in that directory. PATHs
  102.                are preserved. The SCAN.EXE program from McAfee Associates (C),
  103.                is called to scan all files and any subdirectories created by
  104.                the decompressor. If any errorlevel other than zero is returned
  105.                by SCAN, the archive is deemed infected with a virus and
  106.                SCANVERT will abort with a non zero errorlevel.
  107.  
  108.            9.- If the virus test is good, then if you set a convert archive in
  109.                the command line the files will be recompressed using that
  110.                archiver. If it is already of that archive type, then the files
  111.                are cleaned and the program ends with errorlevel zero.
  112.  
  113.           10.- Providing no program has stopped with an errorlevel, all is
  114.                well. Your file has now been converted from the original type to
  115.                the type specified in the command line, taking an intermediate
  116.                detour thru the scanner for viruses.
  117.  
  118.           11.- At this point SCANVERT opens the RA's filebase header and index
  119.                files and upgrades the file name and size to reflect the new
  120.                archive type and size.
  121.  
  122.           12.- SCANVERT will work in multinode systems provided they are
  123.                installed as recommended by the RA docs. Each copy of SCANVERT
  124.                MUST run from a separate subdirectory. So if line 1 is
  125.                c:\ra\raline1 and line 2 is c:\ra\raline2, no conflict will
  126.                occur. Scanvert opens all files in READ/WRITE/SHARE mode so it
  127.                should run fine in networks and coexist with multiple copies of
  128.                itself and RA. It never keeps a file open longer than ncessary,
  129.                so it should cause little problems.
  130.  
  131. Aknowledgments:
  132.  
  133.         My thanks to Ernie Jillson for his questions and encourament and his
  134.         testing.
  135.  
  136.         Turbo Power Software for their excellent swapping units.
  137.  
  138.         Questions and suggestions can be sent to:
  139.  
  140.                         Paul Schencke
  141.                         1:135/340@fidonet or 1:135/58@fidonet
  142.                         72066,2443@Compuserve.com
  143.  
  144.