home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / UPCHK700.ZIP / UPCHECK.DOC < prev    next >
Encoding:
Text File  |  1996-03-07  |  38.1 KB  |  834 lines

  1.  
  2.  
  3.            ▄ ▄ ▄▄▄ ▄▄▄ ▄ ▄ ▄▄▄ ▄▄▄ ▄ ▄
  4.            █ █ █▄█ █   █▄█ █▄  █   █▄▀  The Premium Upload Scanner
  5.            █▄█ █   █▄▄ █ █ █▄▄ █▄▄ █ █         Version 7.0
  6.  
  7.      Copyrighted Pete Rocca & Multiboard Communications Centre, 1994-1996
  8.                               All rights reserved
  9.  
  10.  
  11. ╓───────────────────────────────────────────────────────────────────────────╖
  12. ║ What is it?                                                               ║
  13. ╙───────────────────────────────────────────────────────────────────────────╜
  14.  
  15.     A premium upload scanner, description handler and true duplicate CRC
  16.     detection built in.  Also can write a message to the user, explaining
  17.     why the file failed, and/or to the Sysop with a warning or message
  18.     receipt.  Fast and easy to use!
  19.  
  20.  
  21. ╓───────────────────────────────────────────────────────────────────────────╖
  22. ║ Quick Note                                                                ║
  23. ╙───────────────────────────────────────────────────────────────────────────╜
  24.  
  25.     Although the docs aren't the shortest ones, I suggest  you at least
  26.     skim through them in order to get your system set up correctly... If
  27.     you are confident that you can set up the program then run UPSETUP
  28.     and you can also use the F1 key from that program for online help.
  29.  
  30.     Remember that 90% of all errors are caused by not reading the program
  31.     documentation. :)
  32.  
  33.  
  34. ╓───────────────────────────────────────────────────────────────────────────╖
  35. ║ Overview                                                                  ║
  36. ╙───────────────────────────────────────────────────────────────────────────╜
  37.  
  38.     UpCheck and it's companion utilities are more than any Sysop could
  39.     require in an upload file processing system...
  40.  
  41.     UpCheck is a small and quick program that is capable of scanning an
  42.     upload for file integrity, duplications, as well as being able to
  43.     remove unwanted files, add files and then recompress the archive in
  44.     maximum compression mode.
  45.  
  46.     You also have the ability to quickly insert the FILE_ID.DIZ, DESC.SDI
  47.     or DESC.SDN description into the file base description.  If the file
  48.     does not contain a description, you can search text files, capture
  49.     logs and even other BBS lists for a matching description to insert.
  50.  
  51.     You can set UpCheck to send a message to the user if a file should
  52.     fail, as well as the option to send yourself a receipt of the failure.
  53.  
  54.     If you are using RemoteAccess 2.x, then you can also send online
  55.     messages to the user to detail why a file failed while they're still
  56.     online the system.
  57.  
  58.     UpCheck comes with a program called UpUtils.   This program can
  59.     perform such database features as creating duplicate file signatures
  60.     from your existing collection of files, insert the descriptions of
  61.     files into your file database, quickly comment all of your ZIP files
  62.     in your current hard drive collection, in order to bring them all up
  63.     to date.  UpUtils can also set and return errorlevels depending on
  64.     the type of archive is being processed.
  65.  
  66.     ...in short, UpCheck does what all upload scanners do, and then adds
  67.     features not found in any other scanners.  It combines many features
  68.     that are found in numerous other third party applications - all into
  69.     one extremely inexpensive and powerful package.
  70.  
  71.  
  72. ╓───────────────────────────────────────────────────────────────────────────╖
  73. ║ UpSetup - Configuration program                                           ║
  74. ╙───────────────────────────────────────────────────────────────────────────╜
  75.  
  76.     UpCheck is very easy to install.
  77.  
  78.       1) First, unpack the contents of the archive into a directory
  79.       2) Run the UPSETUP program
  80.  
  81.     Remember that the UPCHECK.CFG file that is created by UpSetup should
  82.     always be in the same directory as the *.EXE files.   Also, the file
  83.     UPCHECK.PAC must also be in the same directory as these above files.
  84.  
  85.     The database  files that you  setup in  UPSETUP do not need to be in
  86.     any particular directory,  but to keep things simple you may want to
  87.     specify that they be created in the same directory.
  88.  
  89.     To save space, and your time, we have installed a comprehensive
  90.     online help system with UpCheck that you can activate from the setup
  91.     program by pressing F1.
  92.  
  93.     If you wish to create a text file from this help file, rather than
  94.     viewing it as you go, you can run HELP2DOC.EXE which will create
  95.     a readable documentation file detailing each option.
  96.  
  97.  
  98. ╓───────────────────────────────────────────────────────────────────────────╖
  99. ║ UpCheck - Upload scanning program                                         ║
  100. ╙───────────────────────────────────────────────────────────────────────────╜
  101.  
  102.     UpCheck, the executable itself, is the actual scanning program for
  103.     when a user uploads a file.  It is run from your bulletin board in
  104.     a numerous number of ways.  If the following setups do not work for
  105.     your system,  I would suggest that you consult your BBS software
  106.     documentation for info on installation of an upload scanner.
  107.  
  108.     Please remember that when running UpCheck you should have about 400
  109.     to 450k conventional memory available to call the external programs
  110.     for decompression, recompression and scanning.  UpCheck itself only
  111.     takes about 3k when calling these programs, but some of them require
  112.     a lot of memory themselves, so to save problems, it's best to make
  113.     sure you have a lot of memory available.
  114.  
  115.  
  116.     Running UpCheck 7.0
  117.     ──────────────────────────────────────────────────────────────────
  118.  
  119.      UPCHECK [dropfile [/I:hex,irq,locked]] <archive> [node] [options]
  120.  
  121.        <> = Required parameters
  122.        [] = Optional parameters
  123.  
  124.        [dropfile]   Full path and filename of EXITINFO.BBS, DORINFOx.DEF
  125.                     or DOOR.SYS.  If no dropfile is specified, then it
  126.                     will run in local mode without any remote display.
  127.  
  128.        [/I:hex..]   Use internal communications routines with the specified
  129.                     information instead of the fossil driver.  For example
  130.                     to not use the fossil driver, but use the internal com
  131.                     routines on COM2 (2f8), IRQ5 and with a locked baud rate
  132.                     of 57600, use /I:2F8,5,57600
  133.  
  134.                     ** IMPORTANT NOTE **
  135.  
  136.                     If you are using the internal communication routines,
  137.                     then UpCheck can not take advantage of it's swapping
  138.                     routines, and if you require more memory to run the
  139.                     scanner and extractors, you will need to use a program
  140.                     called "SHROOM.COM" (freqable using "SHROOM" from me
  141.                     at 1:2401/305)  Another solution might be temporairily
  142.                     installing a fossil driver before UpCheck is run and
  143.                     unloading it afterwards.
  144.  
  145.        <archive>    The archive filename (or wildcard search) to process.
  146.  
  147.        [node]       Define the current node.  This is mainly important
  148.                     for logging purposes.  Also, if you are using the
  149.                     DOOR.SYS file you never need to declare the node number.
  150.  
  151.        [options]    /NOViruscheck - Disable virus checking
  152.                     /NOAgecheck   - Disable file age checking
  153.                     /NODupecheck  - Disable duplicate file checking
  154.  
  155.                                                                                       [node]       Optionally override the node number
  156.     ═══ Running under RemoteAccess 2.x
  157.  
  158.          When running under RemoteAccess, the line that you should enter
  159.          in the...  "Options -> Files -> Upload scan" ...field should look
  160.          something like this:
  161.  
  162.              C:\UPCHECK\UPCHECK.EXE \RA\EXITINFO.BBS @ *N *M
  163.  
  164.          Or if you are running a multinode system:
  165.  
  166.              C:\UPCHECK\UPCHECK.EXE \RA\NODE*N\EXITINFO.BBS @ *N *M
  167.  
  168.          Recall from your RemoteAccess documentation that the *N is replaced
  169.          with the node number and the @ is replaced with the path/name of
  170.          the uploaded file, and that the *M means to use the MemorySwap
  171.          function of RemoteAccess.
  172.  
  173.          Here's an example below...
  174.  
  175.          ═════════════════════════════════════════════════════════════════
  176.          Scan online  Yes
  177.          Failed scan  /move to 58
  178.          Scan utility \RA\DOORS\UPCHECK\UPCHECK.EXE EXITINFO.BBS @ *N *M
  179.          ═════════════════════════════════════════════════════════════════
  180.  
  181.          UpCheck doesn't care  about the Failed Scan action, as RemoteAccess
  182.          will handle it when it gets the Pass or Fail sign from UpCheck.
  183.          You might however, want to either delete it or move it to another
  184.          directory,  as otherwise it will still be available for users.
  185.  
  186.          UpCheck doesn't care about the Scan Online either. If the dropfile
  187.          is missing, it will assume that there is no user online and will
  188.          surpress any output to the modem.  Note though, that if a dropfile
  189.          cannot be found, UpCheck can't figure out who is uploading the
  190.          file, therefore will not send mail to anyone should a file fail.
  191.  
  192.          Also remember to turn on upload scanning in the area(s) that you
  193.          permit uploads.
  194.  
  195.          You might also want to change the language prompt # 637 from
  196.          "Failed Virus Scan" to "Failed" as there are many reasons a file
  197.          can fail.
  198.  
  199.     ═══ Running under TriBBS
  200.  
  201.          When running under TriBBS, turn the "Scan Uploads" to "NO" in the
  202.          setup.  TriBBS looks for a file called "UPLOAD.BAT"  file in its
  203.          node directory, and runs it if it exists.
  204.  
  205.          Therefore you should place a file called "UPLOAD.BAT" that looks
  206.          similar to this, in _EACH_ of your node directories.
  207.  
  208.          --- UPLOAD.BAT
  209.              @echo off
  210.              c:\upcheck\UPCHECK.EXE c:\tribbs\dorinfo1.def %1
  211.              if errorlevel 1 goto :fail
  212.              goto :end
  213.              :fail
  214.              rem *** actions to take on failed file ***
  215.              move %1 c:\badfiles
  216.              c:\upcheck\UPUTILS.EXE /E 1
  217.              :end
  218.  
  219.              ( Of course change the paths mentioned  )
  220.              ( here to paths that reflect your setup )
  221.  
  222.          If you are running more than one node, then copy the UPLOAD.BAT
  223.          to each node directory, and change the reference from node 1 to the
  224.          other nodes, for example: c:\tribbs to show as c:\tribbs2, etc.
  225.  
  226.          It seems that some TriBBS users have had a problem when using
  227.          the DOOR.SYS dropfile when scanning, therefore I would suggest
  228.          using the DORINFOx.DEF file if you have any problems.
  229.  
  230.     ═══ Running under SuperBBS 1.17+
  231.  
  232.          When running under SuperBBS, you should set the CONFIG.EXE ══
  233.          Paths ══ Virus Scanner to look something like this:
  234.  
  235.              C:\UTIL\UPCHECK.EXE C:\SBBS\DORINFO1.DEF %1
  236.  
  237.              ( Where %1 is the drive\path\filename.ext )
  238.  
  239.          Also CONFIG.EXE ══ Paths ══ Virus Check, should be set to "Yes".
  240.          If you require or have a more complex setup, you can either edit
  241.          your BBS.BAT file, or call a batch file for scanning, instead the
  242.          actual EXE file. Remember that UpUtils can be utilized to change
  243.          and report errorlevels as needed.
  244.  
  245.     ═══ Running under PCBoard
  246.  
  247.          Running under PCBoard is a little different then  for most systems.
  248.          You will need a batch file that looks something like this:
  249.  
  250.          --- PCBTEST.BAT
  251.              @echo off
  252.              if not %2 == UPLOAD goto :not_upload
  253.          δ   TYPE %3 >> c:\pcb\main\public
  254.              DEL %3
  255.              IF exists pcbfail.txt DEL pcbfail.txt
  256.              c:\upcheck\UPCHECK.EXE door.sys %1
  257.              IF errorlevel 1 ECHO. > pcbfail.txt
  258.              goto :end
  259.  
  260.              REM --------------------------------------------
  261.              REM This is the part for non-upload testing...
  262.              REM Used from the original PCBTEST.BAT
  263.              REM --------------------------------------------
  264.              :not_upload
  265.              testfile %1 arc zip
  266.              if errorlevel == 98  goto end
  267.              if errorlevel == 2   goto zip
  268.              if errorlevel == 1   goto arc
  269.              goto end
  270.  
  271.              :zip
  272.              echo ■ Testing ZIP file integrity
  273.              pkunzip -t %1 > pcbfail.txt
  274.              if errorlevel == 1 goto end
  275.              del pcbfail.txt
  276.              goto end
  277.  
  278.              :arc
  279.              echo ■ Testing ARC file integrity
  280.              pkxarc -t %1 > pcbfail.txt
  281.              if errorlevel == 1 goto end
  282.              del pcbfail.txt
  283.              goto end
  284.  
  285.              :end
  286.  
  287.          δ   In the above example the c:\pcb\mail\public
  288.              is the name of your upload directory.
  289.  
  290.  
  291.     ═══ Running under other BBS software
  292.  
  293.          UpCheck can run under practically any type of BBS software with
  294.          few modifications or troubles.  The key things to remember are
  295.          that you should turn on the Upload Scanning feature of your
  296.          software, and for the file name of the Upload Scanning Program,
  297.          just insert UPCHECK.EXE with the appropriate parameters as
  298.          mentioned above.
  299.  
  300.  
  301. ╓───────────────────────────────────────────────────────────────────────────╖
  302. ║ UpCheck - The log file                                                    ║
  303. ╙───────────────────────────────────────────────────────────────────────────╜
  304.  
  305.     The log file contains information about who uploaded what, and what
  306.     happened to the file.  It has four possible entry types...
  307.  
  308.     1) User: This is the user's name
  309.     2) File: This is the file that was processed
  310.     3) Code: This is a code to explain an error if one occurred
  311.     4) Stat: This is the status of the file
  312.  
  313.     Below is  a table that  gives a reference  to many  of the possible
  314.     values that "Code" may return.
  315.  
  316.        ═════╤════════════════════════════════════════════════════════
  317.        Code │ Section = Program return codes
  318.        ═════╪════════════════════════════════════════════════════════
  319.         0-x │ Every program has its own return code setup, consult
  320.             │ its documentation regarding the (x) return code
  321.  
  322.        ═════╤════════════════════════════════════════════════════════
  323.        Code │ Section = Swapping routines
  324.        ═════╪════════════════════════════════════════════════════════
  325.         1-1 │ No space for swapping
  326.         1-2 │ Program is too low in memory
  327.         4-0 │ Error allocating environment
  328.         5-0 │ Error calling swap
  329.         5-1 │ Could not return from swap
  330.         5-2 │ Could not swap out
  331.         6-x │ Error caused during redirection
  332.  
  333.        ═════╤════════════════════════════════════════════════════════
  334.        Code │ Section = Program being called
  335.        ═════╪════════════════════════════════════════════════════════
  336.         2-0 │ Not found
  337.         2-1 │ Invalid drive
  338.         2-2 │ Invalid path
  339.         2-3 │ Invalid name
  340.         2-4 │ Invalid drive letter
  341.         2-5 │ Path too long
  342.         2-6 │ Drive not ready
  343.  
  344.        ═════╤════════════════════════════════════════════════════════
  345.        Code │ Section = Dos error codes
  346.        ═════╪════════════════════════════════════════════════════════
  347.         3-2 │ File not found
  348.         3-3 │ Path not found
  349.         3-5 │ Access denied
  350.         3-6 │ Invalid handle
  351.         3-8 │ Not enough memory
  352.  
  353.  
  354. ╓───────────────────────────────────────────────────────────────────────────╖
  355. ║ UpUtils - System Utilities                                                ║
  356. ╙───────────────────────────────────────────────────────────────────────────╜
  357.  
  358.     UpUtils is a supplementary program that is designed to simplify the
  359.     job of creating duplicate  databases and  making sure  that all the
  360.     file  descriptions are correct,  as  well as  add support for third
  361.     party utilities.  Wildcards are valid for UpUtils.
  362.  
  363.  
  364.     Running UpUtils
  365.     ──────────────────────────────────────────────────────────────────
  366.  
  367.     ═══ Command line parameters
  368.  
  369.          /A = Add the files signature into the bad files listing. This
  370.               is good for files that stay the same except their name,
  371.               like randomly named BBS ads.
  372.  
  373.          /I = Enable the insertion of descriptions that are included
  374.               inside some of the files.   This allows you to quickly
  375.               put your descriptions into the data base.
  376.  
  377.          /Y = Yank descriptions from text files.  This switch will extract
  378.               descriptions from other BBS lists, captured logs, FILES.1
  379.               type files, in just about any format.
  380.  
  381.               If the file does not contain a FILE_ID.DIZ, DESC.SDI or
  382.               DESC.SDN, then UpUtils will attempt to locate the files in
  383.               the 'Description Files', that are set in UpSetup.  If found,
  384.               it will extract the description from the text files and insert
  385.               it into the FDB
  386.  
  387.               The "/I"  switch must be on for the "/Y" switch to operate.
  388.  
  389.          /D = Enable duplicate checking & building.  This allows you to
  390.               build a dupe list of all your files that are presently
  391.               on your system.
  392.  
  393.          /K = Kill duplicate files.  This switch will cause all the files
  394.               that are checked and duplicates to be deleted.
  395.  
  396.               **USE THIS WITH EXTREME CAUTION**
  397.  
  398.               You could lose all your files if you do not use this one
  399.               properly.   The "/D" switch must be on for the "/K" switch
  400.               to operate.
  401.  
  402.          /P = This is the same as the /K switch but will prompt you for a
  403.               decision before deleting the file.  The "/D" switch must be
  404.               on for the "/P" to operate.
  405.  
  406.          /S = Scan subdirectories.   This switch is useful when doing all
  407.               your files as it allows the program to search the specified
  408.               directory and all of its lower subdirectories also.
  409.  
  410.          /Q = Query the database.  This switch will return the current
  411.               statistics of the database holding the information on the
  412.               number of files processed, failed and passed, etc.
  413.  
  414.          /C = Comment ZIP files.  This switch will comment the ZIP files
  415.               it comes in contact with,  with the ZIP comment file as
  416.               specified in UpSetup.
  417.  
  418.          /Z = Purge the duplicate files database.  This command will remove
  419.               signatures of files that are smaller than the 'minimum size to
  420.               store' setting.  The benefits of a smaller database is mainly
  421.               speed while checking for any duplicate files.  The drawback
  422.               is the chance of smaller files passing the dupe check when
  423.               they are duplicates.
  424.  
  425.          /E = Returns an errorlevel as specified.  This is only good when
  426.               creating an advanced batch file setup.   Refer to the next
  427.               section for more info.
  428.  
  429.          /R = Returns an errorlevel associated to the type of file processed.
  430.               Again, this is for the advanced batch file setups.
  431.  
  432.          The UpUtils program also requires a file specification for files
  433.          to process.   Wild cards are valid.  For example, if you want
  434.          to process all ZIP files, you would put "*.ZIP" for your file
  435.          specification.
  436.  
  437.          Although UpCheck will handle multi-level embedded archives,
  438.          UpUtils only will seek into the original archive.  The reason for
  439.          this, is that any other way would make the building of your
  440.          database too incredibly time consuming, and that the first level
  441.          is usually more then enough for testing.
  442.  
  443.          If you require each file to be processed fully, use UpCheck in
  444.          local mode instead of UpUtils.
  445.  
  446.  
  447.     Sample batch files for automated tools
  448.     ──────────────────────────────────────────────────────────────────
  449.  
  450.     ═══ Batch Files
  451.  
  452.          Download a lot of files but hate uploading them locally or
  453.          running UpCheck in local mode?   Well with UpUtils,  you can
  454.          use a batch file like this...
  455.  
  456.          @echo off
  457.          MOVE \downloads\*.* \bbs\uploads
  458.          UPUTILS /i /d /c \bbs\uploads\*.*
  459.  
  460.          It's a fast way to add the signatures to the duplicate base,
  461.          comment your ZIP files and insert the FILE_ID.DIZ.
  462.  
  463.          If you need to perform full scanning, and to add your BBS file
  464.          to the archive, then use a batch file like this...
  465.  
  466.          @echo off
  467.          move \downloads\*.* \bbs\uploads
  468.          UPCHECK \bbs\uploads\*.*
  469.  
  470.          This will perform the full scanning on the files and add the
  471.          archive comment, archive file, recompress, delete all the
  472.          unwanted files, scan, etc.. and add the FILE_ID.DIZ to the
  473.          filebase description.  Remember that for both of these batch
  474.          files, it's a good idea that the "\bbs\uploads" directory be
  475.          empty before running this, as otherwise, it will process the
  476.          files that had already been processed prior to running the batch
  477.          file.   Also note, that you should replace the "\bbs\uploads"
  478.          and "\downloads" with the appropriate paths for your own system.
  479.  
  480.  
  481. ╓───────────────────────────────────────────────────────────────────────────╖
  482. ║ Advanced User Tools                                                       ║
  483. ╙───────────────────────────────────────────────────────────────────────────╜
  484.  
  485.    With the UpUtils utility you can build your own advanced batch file.
  486.    With a great batch file, you can make just about anything happen with
  487.    your archives.
  488.  
  489.    The two functions /REPORT and /ERRORLEVEL allow for some great ways
  490.    to handle certain conditions.
  491.  
  492.    The easiest way to show how  you can use these is to look at the file
  493.    ADVANCED.BAT that is included in this archive.
  494.  
  495.    Remember that UpCheck does not require that you make such a batch
  496.    file system and will run just fine in 99.99% of all situations. These
  497.    functions are to provide additional ways for you to implement third
  498.    party utilities.
  499.  
  500.  
  501. ╓───────────────────────────────────────────────────────────────────────────╖
  502. ║ Scanning in text for descriptions                                         ║
  503. ╙───────────────────────────────────────────────────────────────────────────╜
  504.  
  505.     With UpUtils, you can retrieve descriptions for files that do not
  506.     have a FILE_ID.DIZ, DESC.SDI or DESC.SDN in them.   This is done by
  507.     setting up some "Description files" in the UpSetup program, and then
  508.     using the "/YANK" switch of UpUtils (with the "/INSERT" switch also)
  509.     What UpUtils will do is scan through these "description files" and
  510.     search for a matching filename.  If one is found, it will grab the
  511.     description that is listed, and insert it into your filebase.  The
  512.     files can be almost any text format, as UpUtils will synchronize the
  513.     descriptions itself.  For example, if you called up a BBS, you could
  514.     turn on your 'capture' function of your terminal, then when you had
  515.     downloaded some files, you could use this capture file as a file to
  516.     search through in case the files didn't have a FILE_ID.DIZ type file
  517.     in them.  This is what you can do:
  518.  
  519.       1) Go into your terminal and start a capture file
  520.       2) Call a BBS and download some files, read mail, whatever
  521.       3) Repeat step 2 as many times as you wish
  522.       4) Exit the terminal
  523.       5) Run UpUtils with /INSERT /YANK /COMMENT  and /DUPE turned
  524.          on, in order to insert all the descriptions (yanked or
  525.          embedded), comment the ZIP files with your logo, and add
  526.          the files data into the duplicate database.
  527.  
  528.     With this you will never need to enter a description manually into
  529.     your file listings again!
  530.  
  531.     Another use for this might be if setting up a new BBS,  and you want
  532.     to add all the descriptions for the files you have.  Well, you could
  533.     download a couple BBS lists from other systems, and use those for
  534.     description files to be yanked from.   Also, if you ever lost your
  535.     descriptions, you could insert them back using your own BBS listing.
  536.  
  537.  
  538. ╓───────────────────────────────────────────────────────────────────────────╖
  539. ║ Running with TBAV                                                         ║
  540. ╙───────────────────────────────────────────────────────────────────────────╜
  541.  
  542.     UpCheck will run with any scanning system created now or in the
  543.     future.  UpCheck will handle multiple scanners, because it can call
  544.     any program you wish, including batch files.  Here's an example file
  545.     that will use McAfee's scanning system, and then ThunderByte after.
  546.  
  547.          @echo off
  548.          SCAN *.* /sub /nomem /nopause        (for McAfee Scan v1.x)
  549.          SCAN *.* /sub /nomem                 (for McAfee Scan v2.x)
  550.          if errorlevel 1 goto :end
  551.          if exist *.exe goto :next
  552.          if exist *.com goto :next
  553.          if exist *.sys goto :next
  554.          goto :end
  555.          :next
  556.          TBSCAN nb nm nh ba lo ll=0 ap ol ln=c:\upcheck\upcheck.log
  557.          :end
  558.  
  559.     To implement this,  select UpSetup ═ External Programs ═ Scanning and
  560.     replace the "SCAN.EXE etc" with  the name of the batch file you just
  561.     created.  Now your system is setup to work with TBAV and McAfee.
  562.  
  563.        Scanning Program:  SCAN.BAT
  564.  
  565.           (  Provided SCAN.BAT is in your system path, otherwise  )
  566.           (  include the full path to the batch file you created. )
  567.  
  568.     With the same principles, you can do any type of scanning,  or other
  569.     modifications on archives for that matter, by replacing the standard
  570.     "External Programs" with your own customized batch files.
  571.  
  572.  
  573. ╓───────────────────────────────────────────────────────────────────────────╖
  574. ║ Matchup files                                                             ║
  575. ╙───────────────────────────────────────────────────────────────────────────╜
  576.  
  577.     If you plan on receiving uploads into directories and having the file
  578.     listing for that directory stored in another directory, you will need
  579.     to use a matchup file.
  580.  
  581.     The structure of a matchup file is quite simple:
  582.  
  583.     Full_path_to_file_list,Directory_path_for_uploads
  584.  
  585.     For example, you could call your matchup file MATCHUP.CFG:
  586.  
  587.     C:\PCB\DIR1,C:\FILES\UPLOADS
  588.     C:\PCB\DIR2,C:\FILES\GAMES
  589.     C:\PCB\DIR3,C:\FILES\BBSDOORS
  590.  
  591.     Then you would tell UpCheck to use this matchup file in order to find
  592.     the correct file listing to update when uploads were received.
  593.  
  594.  
  595. ╓───────────────────────────────────────────────────────────────────────────╖
  596. ║ License and Disclaimer                                                    ║
  597. ╙───────────────────────────────────────────────────────────────────────────╜
  598.  
  599.     UpCheck is not free.
  600.  
  601.     It is being marketed under the "try before you buy" or shareware
  602.     concept. You are entitled to use UpCheck, UpSetup, UpUtils and the
  603.     companion utilities for a period up to forty-five (45) days, after
  604.     which you MUST register it or stop using it.
  605.  
  606.     Registration entitles you to use UpCheck and its companion programs
  607.     as well as any future versions of the programs that may or may not
  608.     be released, subject to any new licensing arrangements. Registration
  609.     will also unlock all of the features that UpCheck is capable of. (In
  610.     other words, the {+} features)
  611.  
  612.     By running any of the executable programs included, you agree that
  613.     Pete Rocca, nor any affiliates of Pete Rocca are responsible for
  614.     any damage ever experienced, however so created. If you cannot agree
  615.     to this, then your privilege to use any of these programs is revoked
  616.     and it becomes illegal for you to execute any programs included with
  617.     this documentation.
  618.  
  619.     You may freely copy and distribute the shareware version of UpCheck
  620.     as long as its original archived contents are not modified in any
  621.     way.  You may not distribute a registration key without the express
  622.     written consent of Pete Rocca at Multiboard Communications Centre.
  623.     You may not use a registration key that is not licensed to you by
  624.     Pete Rocca, the author of this program.
  625.  
  626.     It is illegal to edit, alter, hack, reverse engineer and / or modify
  627.     any components of the UpCheck archive in any manner.
  628.  
  629.     If dispute of any issues on legal grounds said above, then governing
  630.     law of Ontario, Canada will rule.
  631.  
  632.  
  633. ╓───────────────────────────────────────────────────────────────────────────╖
  634. ║ Registration                                                              ║
  635. ╙───────────────────────────────────────────────────────────────────────────╜
  636.  
  637.     UpCheck is probably one of the most powerful utilities that you will
  638.     have running on your system.  - It's probably also the lowest priced
  639.     piece of Shareware that does so much.   Compare all it's features to
  640.     some programs that only perform one or two of it's functions and are
  641.     more expensive.  If you continue to use this product, please support
  642.     it, and mail in your registration.
  643.  
  644.     Simply fill out the included registration form and mail it to the
  645.     address specified within.
  646.  
  647.  
  648. ╓───────────────────────────────────────────────────────────────────────────╖
  649. ║ Support                                                                   ║
  650. ╙───────────────────────────────────────────────────────────────────────────╜
  651.  
  652.    If you have any questions or comments, you  can netmail me at FidoNet
  653.    address 1:2401/305 (XA,CM,V34,VFC,V32,V42).  Please poll back within
  654.    24 - 48 hours for a reply, or request  that I route the message back
  655.    to you.
  656.  
  657.    Also you can contact me via the internet at "support@multiboard.com"
  658.    or visit our WWW page at "http://www.mgl.ca/~multib".  You can also
  659.    find our latest releases at "ftp://ra.uti.com/sys/bbs/bbs/mcc"
  660.  
  661.    You can also find me in the RemoteAccess Utilities FidoNet area, as
  662.    well as in the MCC_SUPPORT FidoNet echo as well.
  663.  
  664.  
  665. ╓───────────────────────────────────────────────────────────────────────────╖
  666. ║ Common questions and answers                                              ║
  667. ╙───────────────────────────────────────────────────────────────────────────╜
  668.  
  669.     Q: Can I run it with TBAV and F-PROT?
  670.     A: Yes,  read the "Running with TBAV" section,  and simply adjust the
  671.        batch file as need.
  672.  
  673.     Q: My users don't get anything on their side when UpCheck is running?
  674.     A: Make sure that the dropfile (DOOR.SYS, DORINFOx.DEF, etc) is where
  675.        you have specified on the command line. If the dropfile is missing
  676.        UpCheck will run in local mode only.
  677.  
  678.     Q: It seems to lockup during zipping or unzipping.
  679.     A: Try adding "-)"  (without the quotes)  to the end  of the .ZIP de/
  680.        recompression lines. This disables the DPMI option of ZIP which is
  681.        not fully compatible with some DPMI servers.
  682.  
  683.     Q: Do I have to put the files in my path?
  684.     A: No,  nor do you need to set any environment variables. If you want
  685.        to be able to  run these files  from anywhere on your system,  you
  686.        might want  to make some  batch files that  are in your path, that
  687.        would simply look like this:
  688.  
  689.        --- UPCHECK.BAT
  690.        @echo off
  691.        c:\upcheck\UPCHECK.EXE %1 %2 %3
  692.  
  693.        --- UPUTILS.BAT
  694.        @echo off
  695.        c:\upcheck\UPUTILS.EXE %1 %2 %3 %4 %5 %6 %7 %8 %9
  696.  
  697.     Q: Will UpCheck work properly on multinode systems if someone else is
  698.        uploading, or browsing the file areas?
  699.     A: Absolutely.  UpCheck is able to fully scan files, check duplicates
  700.        update the filebase and  post messages when  other nodes are using
  701.        the same files.  UpCheck is fully SHARE/Network locking aware.
  702.  
  703.     Q: I noticed that  with 2400 baud callers,  sometimes the file starts
  704.        scanning before they have the updated screen?
  705.     A: Yes, UpCheck will dump the screen to the modem,  and then start to
  706.        perform its tasks.   This way,  the user has less time to wait for
  707.        their upload to be processed.
  708.  
  709.     Q: Can I disable virus scanning?
  710.     A: Yes, specify the scanning program as "OFF" (without the quotes)
  711.  
  712.     Q: Does UpCheck work with OS/2?
  713.     A: Yes.  This program has not had any reported bugs when running with
  714.        OS/2 2.0 through 3.0, as well as WinOS/2, DESQview 2.40 through 2.63,
  715.        DESQview/X 1.2 through 2.0 and MS-DOS 3.0 through 7.0.  It also
  716.        works under Windows 3.x, WindowsNT and Windows95.
  717.  
  718.     Q: I see this wierd  blue square  flashing in the top right corner of
  719.        my screen.
  720.     A: This is an indicator to you  that file access has been denied from
  721.        UpCheck or UpUtils for more than a half a second. It will continue
  722.        for about 30 seconds or until the files are made  available to it.
  723.        This is to let you know the current situation, so you do not think
  724.        that your system is 'frozen' or 'hung'.  The square  will never be
  725.        displayed to a remote caller.
  726.  
  727.     Q: The file listings are not being updated!
  728.     A: There are a number of reasons this might be happening.
  729.          The most common are...
  730.          1) scanning files in a directory that is not defined in either
  731.             the FILES.RA (RemoteAccess 2.x) or in the matchup file for
  732.             non-RemoteAccess 2.x users.
  733.          2) the filebase was locked for more that 30 seconds
  734.          3) the filelist name in the matchup file is incorrect
  735.  
  736.  
  737. ╓───────────────────────────────────────────────────────────────────────────╖
  738. ║ Errors                                                                    ║
  739. ╙───────────────────────────────────────────────────────────────────────────╜
  740.  
  741.    If you ever get a runtime error, chances are pretty good that you have
  742.    incorrectly specified a path or file name, or you that the UPCHECK.CFG
  743.    or UPCHECK.DAT file is corrupted.
  744.  
  745.    In any case, if you ever get a runtime error, the only thing that will
  746.    most likely happen is that the  file will report failed.  Any runtime
  747.    errors will NOT cause your system to 'hang'.
  748.  
  749.    Any logical errors or runtime errors that you cannot seem to resolve
  750.    should be reported to 1:2401/305 for my evaluation, please include the
  751.    error number and location, the look of the screen and the current task
  752.    that the program was under and I will get back to you with a solution.
  753.  
  754.         Example : Runtime error 103 at 05C3:3029
  755.                                   \         \
  756.                                    Number    Location
  757.  
  758.  
  759.    Other neat stuff:
  760.  
  761.    UpCheck avoids a large number of problems that other scanners seemed
  762.    to have over looked.  The classic one is this:
  763.  
  764.       a) a file called TEST.ARJ gets uploaded and rearchived to ZIP
  765.          format so now a file called TEST.ZIP exists
  766.  
  767.       b) a different program called TEST.LZH gets uploaded and
  768.          rearchived to  ZIP, the BBS allowed the upload because the
  769.          file TEST.LZH did not exist, but the scanner failed to
  770.          realize that another program already existed in the same
  771.          directory with the same name.  The scanner would either
  772.          delete the first file, or add all of TEST.LZH's files into
  773.          the first file. Yuck!
  774.  
  775.    UpCheck would have renamed the second file TEST.ZI0 and updated the
  776.    filebase accordingly. UpCheck will continue renaming from ZI0 to ZI9
  777.    to ZIA to ZIZ as files are duplicated. (Although the rarity of any of
  778.    this happening is so far fetched, it shows the detail and concern
  779.    that UpCheck exhibits)
  780.  
  781.    Many other scanners will also not update the filebase with the new
  782.    size or type of the file once rearchived (and/or the garbage killed)
  783.    but UpCheck will always update the base.
  784.  
  785.    Also, many scanners either abort or 'freeze' the system if a caller
  786.    hangs up during scanning.... not UpCheck.
  787.  
  788.    Also, if the file doesn't exist in the filebase, some scanners will
  789.    not update it with the added information, or the FILE_ID.DIZ files.
  790.  
  791.    If you find a problem, PLEASE let me know as soon as possible so I
  792.    can fix it and get you rolling again in no time flat!
  793.  
  794.  
  795. ╓───────────────────────────────────────────────────────────────────────────╖
  796. ║ Acknowledgments                                                           ║
  797. ╙───────────────────────────────────────────────────────────────────────────╜
  798.  
  799.     Requires at least Dos 3.3 and  about 450k free conventional memory.
  800.     (Can't do much about the memory problem, only 3k of that is mine,
  801.     the rest you can blame on McAfee and the author of SQZ.) SHARE.EXE
  802.     must also be loaded for Dos systems.
  803.  
  804.     The JAM message base format is used in UpCheck and  this is the JAM
  805.     license header...  "JAM(mbp) - Copyright 1993 Joaquim Homrighausen,
  806.     Andrew Milner, Mats Birch, Mats Wallin. ALL RIGHTS RESERVED."   The
  807.     RemoteAccess filebase format, RemoteAccess and RA are (C) Copyright
  808.     Andrew Milner and Wantree Development, 1993.   All rights reserved.
  809.     The TriBBS  message base format is Copyright 1993 Mark D.  Goodwin.
  810.     SuperBBS Bulletin  Board Software is Copyright (C) 1990-1993, Risto
  811.     Virkkala and Aki Antman.  The PCBoard software is Copyright (C)1993
  812.     by Clark Development Company, Inc.
  813.  
  814.     PKZIP/UNZIP,PKARC/PKXARC, Copyright PKWARE; ARJ, Copyright Robert K
  815.     Jung; LZH/LHA, Copyright Haruyasu Yoshizaki; PAK,  Copyright NoGate
  816.     Consulting; UC2, Copyright Ad Infinitum Programs;  SQZ, Copyright J
  817.     I. Hammarberg;  SCAN, Copyright by McAfee Associates;  TBSCAN/TBAV,
  818.     Copyright Thunderbyte B.V; X00, Copyright Ray Gwinn; BNU, Copyright
  819.     David Nugent & Unique Computing; DESQview, Copyright by Quarterdeck
  820.     Software;  MS-DOS, MS-Windows,  Copyright by Microsoft Corporation;
  821.     OS/2, Copyright International Business Machines Corporation. Thanks
  822.     to the  public domain swapping  utilities that required very little
  823.     in the way of tweaking, by Thomas Wagner. GIF(tm) is a trademark of
  824.     CompuServe. JPG is maintained by an ISO WorkGroup and ANSI.
  825.  
  826.     Also, a BIG THANKS, to my wife Laurie,  who hates me being on 'this
  827.     damn machine', but still finds the way to support me.  Thank you.
  828.  
  829.     Thanks to you,  the user,  for actually reading to the  end  of the
  830.     documentation, and remember, please register, it's cheap!
  831.  
  832.  
  833.                            * Documentation End *
  834.