home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / UPCHECK / LABTST27.ZIP / LABTEST.DOC < prev    next >
Text File  |  1993-12-04  |  38KB  |  706 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.            ┌─┐  ┌──────┌──────┌─────┌─────┌─────┌─────┐  ┌─────┐┌───────┐
  16.            │ │  │ ┌──┐ └┐ ┌─┐ ├─┐ ┌─│ ┌───│ ┌───└─┐ ┌─┘  └───┐ │└─────┬─┤
  17.            │ │  │ └──┘  │ └─┘ │ │ │ │ └─┐ │ └───┐ │ │    ┌───┘ │      │ │
  18.            │ │  │ ┌──┐  │ ┌─┐ │ │ │ │ ┌─┘ └───┐ │ │ │    │ ┌───┘      │ │
  19.            │ └──│ │  │ ┌┘ └─┘ │ │ │ │ └───┌───┘ │ │ │    │ └───┐ ┌─┐  │ │
  20.            └────└─┘  └─└──────┘ └─┘ └─────└─────┘ └─┘    └─────┘ └─┘  └─┘
  21.  
  22.                       Copyright (c) 1993 by Mark Williamson
  23.  
  24.            I would like to begin by thanking the following people for their
  25.            contributions to the development of Labtest. Without their help,
  26.            this program wouldn't be possible!
  27.  
  28.            Brian Pirie for writing an awesome door writing library
  29.  
  30.            Steve  Joselson for  his patience  while beta  testing (and  for
  31.            seeing it through!)
  32.  
  33.            Mike Ehlert  for his insight with  RemoteAccess and his patience
  34.            for testing the program without actually being asked to do so.
  35.  
  36.            Michael Lecuyer for writing the JAM message writing routine.
  37.  
  38.            Bob Lopinski for some great ideas!
  39.  
  40.            Bill Hull (author of CZip) for some tech-help!
  41.  
  42.            Vince Jacobs for help with RIP.  Thanks Vince!
  43.  
  44.            ╒══════════════════════════════════════════════════════════════╕
  45.            │░░░░░░ LEGAL STUFF ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  46.            ╘══════════════════════════════════════════════════════════════╛
  47.  
  48.            The Graphics Interchange Format(c) is the Copyright property of
  49.            CompuServe Incorporated.  GIF(sm) is a Service  Mark property of
  50.            CompuServe Incorporated.
  51.  
  52.            This product uses the JAM(mbp)  API - Copyright (c) 1993 Joaquim
  53.            Homrighausen, Andrew Milner, Mats Birch, Mats Wallin. ALL RIGHTS
  54.            RESERVED.
  55.  
  56.            This  product uses  the  RIPscrip  language, Copyright  (c) 1993
  57.            Telegrafix Communications, Inc.
  58.  
  59.            ╒══════════════════════════════════════════════════════════════╕
  60.            │░░░░░░ LICENSING INFORMATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  61.            ╘══════════════════════════════════════════════════════════════╛
  62.  
  63.            This program is  not Freeware. This is SHAREWARE  which means it
  64.            is  user-supported software.  If you  use this  program for more
  65.            than 30  days, you are  required to register  or remove it  from
  66.            your system.
  67.  
  68.            The concept works  only with your support. If  you find that you
  69.            can  use this  program, then  a registration  fee of $10.00 U.S.
  70.            funds will  help defray the  development cost and  encourage the
  71.            authorship  of other  programs that  might be  useful to  you. A
  72.            Registration  Form  for  this   purpose  is  included  with  the
  73.            distribution archive and is called ORDER.FRM.
  74.  
  75.            Labtest  is  Copyrighted  (c)  1993  by  Mark Williamson and all
  76.            rights are reserved. You may copy this program and documentation
  77.            for  backup purposes.  You also  may copy  and share  UNMODIFIED
  78.            copies  of the  program  package,  providing that  the copyright
  79.            notice is reproduced and included on all copies.
  80.  
  81.            You may  not sell the  product for a  fee and/or distribute  the
  82.            product  along  with  other  products  without expressed written
  83.            permission from Software Solutions, nor may you modify or remove
  84.            the Copyright Notice from the program or the documentation.
  85.  
  86.            Those who register  this program within one year  of its release
  87.            by the author, will receive a  registration key. The key will be
  88.            delivered either by personal  upload, netmail or postal service.
  89.            Allow up to 6 weeks for delivery.
  90.  
  91.            This  program is  not guaranteed  to do  anything except take up
  92.            hard  disk space.  This program  was written  with the intent to
  93.            support as many BBS systems as possible.
  94.  
  95.            Comments, suggestions  and bug reports are  welcome. If you have
  96.            any, you should contact Mark Williamson at Fidonet 1:214/54.
  97.  
  98.            If  you're  reporting  a  bug,  please  give  as  much detail as
  99.            possible about the  problem you are experiencing so  that it can
  100.            be duplicated and fixed.
  101.  
  102.            ╒══════════════════════════════════════════════════════════════╕
  103.            │░░░░░░ INTRODUCTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  104.            ╘══════════════════════════════════════════════════════════════╛
  105.  
  106.            With  the popularity  of computer  Bulletin Board  Systems (BBS)
  107.            comes  the  risk  of  intrusion  by  computer  viruses which lay
  108.            dormant  and  normally  undetected  within  a compressed archive
  109.            file. These archive files are usually created using some sort of
  110.            compression program, like PKZIP or  ARJ. With the advent of file
  111.            compression  programs  comes  the  increased  likelihood  that a
  112.            computer virus may  be lurking within the files  of the archive,
  113.            undectable  by  any  virus   scanning  program  unless  actually
  114.            decompressed.
  115.  
  116.            Labtest was  designed as a  RemoteAccess 2.xx utility  to aid in
  117.            the fight  against viral intrusion. Labtest  will uncompress the
  118.            archived file,  run one or more  Sysop definable virus scanners,
  119.            and  report  the  results  to  the  user  online  and the Sysop.
  120.            However,  Labtest  will  do  much  more  than this simple little
  121.            chore. Labtest will also check  .GIF files for minimum desirable
  122.            resolution  factors;  update  RemoteAccess  2.xx  file  database
  123.            system with the correct filename,  size and description (as read
  124.            from a FILE_ID.DIZ/DESC.SDI file if one exists), remove unwanted
  125.            'junk' files from the archive file, add any Sysop defined 'junk'
  126.            files to  the archive, and  add the Sysop's  own archive comment
  127.            text (.ZIP/ARJ files).
  128.  
  129.            The  author feels  that the  Sysop should  have complete control
  130.            over the files that are  placed on his system, therefore Labtest
  131.            now has the ability to reject  files based on age, in years. For
  132.            example, if a  file is more than 3 years  old, Labtest will fail
  133.            the file.
  134.  
  135.            Hint: If a  user starts a file description  with a forward slash
  136.            '/',  this tells  RemoteAccess that  the file  is for  the Sysop
  137.            only.  Labtest  will  honor  this  even  if  a  FILE_ID.DIZ  was
  138.            imported.
  139.  
  140.            ╒══════════════════════════════════════════════════════════════╕
  141.            │░░░░░░ INSTALLATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  142.            ╘══════════════════════════════════════════════════════════════╛
  143.  
  144.            Installation of  Labtest is relatively simple.  You may create a
  145.            directory especially  for Labtest or  you may wish  to place the
  146.            program and support files in your RemoteAccess system directory.
  147.            The  location of  Labtest  is  unimportant. To  install Labtest,
  148.            unpack the distribution archive into your desired directory. You
  149.            must set the LABTEST environment  variable to tell Labtest where
  150.            to find the configuration file.  Insert the following command in
  151.            your AUTOEXEC.BAT file to  set the LABTEST environment variable:
  152.            SET LABTEST=C:\LABTEST (specify your own directory). The Labtest
  153.            environment  variable is  NOT optional!  If you  don't set  this
  154.            variable, Labtest will NOT RUN. Using your favorite text editor,
  155.            load the file LABTEST.CFG and specify your preferred settings.
  156.  
  157.            Beggining with version 2.5e, you now have the option of having a
  158.            different configuration file for each  node your system runs. To
  159.            create a  config file for  each of your  nodes, simply copy  the
  160.            LABTEST.CFG file to LABTEST.Cnn, where  nn is the node number, 1
  161.            being node 1  and so one. Do not place  any leading zeros in the
  162.            node number.  For example, LABTEST.C1 is  the configuration file
  163.            for node 1. Using this multi-file configuration, you can further
  164.            customize Labtest for your system.
  165.  
  166.            Labtest  will  look  for   the  file  LABTEST.Cnn  first,  then,
  167.            LABTEST.CFG.
  168.  
  169.            Labtest configuration options are discussed below:
  170.  
  171.            Messages to User/Sysop
  172.            ────────────────────────────────────────────────────────────────
  173.  
  174.            In the distribution archive you should find several *.MSG files.
  175.            These files contain text which  will be imported by Labtest into
  176.            the message  base. These messages  may be totally  customized by
  177.            you to give your system a personal touch. There are a few macros
  178.            which will be expanded by  Labtest during reading of the message
  179.            file.  These are explained below:
  180.  
  181.                @SYSOP@          Sysop name (as defined in RACONFIG)
  182.                @BBS@            BBS system name (RACONFIG)
  183.                @USERFIRST@      First name of the user
  184.                @UPLOADS@        Total number of uploads the user has posted
  185.                @UPLOADK@        Uploads (in K) the user has posted
  186.                @AGE@            Maximum age in years for files
  187.                @GIFRESOLUTION@  Minimum acceptable GIF resolution
  188.  
  189.            Keep  in mind  the width of each  of these  macros when they are
  190.            expanded. Labtest  will not word wrap  the text and it  may look
  191.            choppy if your text lines are too long.
  192.  
  193.            The  messages written  to the  Sysop are  coded into Labtest and
  194.            cannot be changed.
  195.  
  196.            Some  settings which  are read  from the  RemoteAccess CONFIG.RA
  197.            file are discussed below:
  198.  
  199.            CONFIG.RA Path:
  200.  
  201.                Labtest  will  get  this   path  from  your  RA  environment
  202.                variable.  You must  ensure that  you have  SET RA=C:\RA (or
  203.                whatever) in your AUTOEXEC.BAT file.
  204.  
  205.            Message Base Directory:
  206.  
  207.                Obtained  from RACONFIG.PATHS.MSG_BASE_DIRECTORY,  this path
  208.                name  is where  Hudson your  message base  files are stored.
  209.                Labtest will use the information contained in LABTEST.CFG to
  210.                determine where to  post messages to the user  and the sysop
  211.                concerning the uploaded file. If  you are using JAM, Labtest
  212.                will  determine the  correct JAM  message base path/filename
  213.                from your MESSAGES.RA file according to the board number you
  214.                specify in LABTEST.CFG.
  215.  
  216.            File Base Directory:
  217.  
  218.                Obtained from  RACONFIG.PATHS.FILE_BASE_DIRECTORY, this path
  219.                is the  base directory of your  file database.  Usually this
  220.                is something like C:\RA\FDB.
  221.  
  222.            System Name:
  223.  
  224.                Obtained from  RACONFIG.SITE_INFO, this is the  name of your
  225.                BBS system.
  226.  
  227.            Sysop Name:
  228.  
  229.                Obtained from  RACONFIG.SITE_INFO, this is  the name of  the
  230.                System Operator.
  231.  
  232.            Compression utilities:
  233.  
  234.                Labtest   will   utilize   the   information  obtained  from
  235.                RACONFIG.FILES.ARCHIVERS for the  pack/unpack utilities. See
  236.                below for details on setting up archivers in RACONFIG.
  237.  
  238.            You  must ensure  that each  of your  file areas  are configured
  239.            properly for scanning. Each file area  must have the UL Scan set
  240.            to YES,  and an archive  type defined. If  you want all  of your
  241.            files in the same format, then leave all the Archive Type fields
  242.            blank, and Labtest will use the format indicated in LABTEST.CFG.
  243.            It  is also  important to  set  the  LongDesc field  to Yes,  so
  244.            RemoteAccess will properly  display descriptions Labtest obtains
  245.            from FILE_ID.DIZ/DESC.SDI files.
  246.  
  247.            In RACONFIG, under Files > Upload > Scanner, enter the following:
  248.  
  249.            C:\RA\LABTEST.EXE @ /O *! *M
  250.               ^^ Labtest directory.
  251.  
  252.            To  setup the  archivers, ensure  that each  Pack/Unpack command
  253.            line has  a @ represent the  filename. The full path  names have
  254.            been omitted here  so you could see the  entire command line. On
  255.            your system,  you must specify  the entire path  to each archive
  256.            utility.
  257.  
  258.                    Ext    Unpack Cmd           Pack Cmd
  259.  
  260.              Arc 1 ZIP    C:\PKUNZIP.EXE -E @  C:\PKZIP.EXE -A @
  261.              Arc 2 ARJ    C:\ARJ.EXE x -y @    C:\ARJ.EXE a -r -jm @
  262.              Arc 3 LZH    C:\LHA.EXE e @       C:\LHA.EXE a @
  263.              Arc 4 PAK    C:\PAK.EXE e @       C:\PAK.EXE a @
  264.              Arc 5 SDN    C:\PAK.EXE e @       C:\PAK.EXE a @
  265.              Arc 6 ZOO    C:\ZOO.EXE e @       C:\ZOO.EXE a @
  266.              Arc 7 SQZ    C:\SQZ.EXE X @       C:\SQZ.EXE A /SP1 @
  267.  
  268.            Labtest may  now be configured  to convert GIF(tm)  files to JPG
  269.            files or vice versa. Two programs, CJPEG.EXE (Compress JPEG) and
  270.            DJPEG.EXE  (Decompress  JPEG),  are  supplied  with  the Labtest
  271.            distribution archive.
  272.  
  273.            If you plan  on converting GIF files to JPG,  you should add the
  274.            following  in  your  archiver  definitions  (Note  that you only
  275.            specify a PACK command, not an unpack command):
  276.  
  277.                    Ext    Unpack Cmd       Pack Cmd
  278.  
  279.              Arc 8 GIF    <leave blank>    C:\CJPEG.EXE -Q 80 @
  280.  
  281.            The CJPEG  program accepts a Quality  Resolution parameter (-Q).
  282.            Specify  a number  from 0  - 100.  A Quality Resolution produces
  283.            best results, maintaining image  quality while getting favorible
  284.            compression  ratios. The  lower the  -Q facter,  the more grainy
  285.            your images will become.
  286.  
  287.            However, if  you plan on converting  JPG files back to  GIF, you
  288.            should add the following in  your archiver definitions (Not that
  289.            you only specify an UNPACK command, not a pack command):
  290.  
  291.                    Ext    Unpack Cmd       Pack Cmd
  292.  
  293.              Arc 8 JPG C:\DJPEG.EXE @      <leave blank>
  294.  
  295.            CAUTION: Handmade Software's  shareware program GIF2JPG produces
  296.            files  that are  totally incompatible  with these  programs (and
  297.            everyone else's too).  They use a proprietary format  that is an
  298.            amalgam of GIF and JPEG  representations. However, you can force
  299.            GIF2JPG  to produce  compatible files  with its  -j switch,  and
  300.            their decompression program JPG2GIF can  read the .JPG files (at
  301.            least ones produced with our default option settings).
  302.  
  303.            DJPEG will  uncompress a JPEG  file, resulting in  like-original
  304.            image quality. It is important to  note here that DJPEG will NOT
  305.            decompress   a   file   compress   with   GIF2JPG.EXE.  However,
  306.            JPG2GIF.EXE  will  properly  handle  a  JPG  file  compressed by
  307.            CJPEG.EXE.
  308.  
  309.            Below is  a screen snapshot of  the Upload Scanner menu  to show
  310.            you  how to  setup Labtest  in your  Upload Scan utility command
  311.            line. Labtest will not move or delete files that fail any of the
  312.            tests, thus it is important to set up RA to handle it.
  313.  
  314.            ╒══════════════════════════════════════════════ Upload Scanner ┐
  315.            │                                                              │
  316.            │ Scan online  Yes                                             │
  317.            │ Failed scan  /unavailable                                    │
  318.            │ Scan utility C:\RA\LABTEST.EXE @ /O *! *M                    │
  319.            │                                                              │
  320.            ╘═════════════════════════════════════════════════════════════─┘
  321.  
  322.            You must make  sure the file areas are  setup correctly. Labtest
  323.            will  look  in  FILES.RA  for  your  preferred  archive type. If
  324.            nothing is defined  there, Labtest will default to  the type set
  325.            in LABTEST.CFG. The two important pieces of information here are
  326.            the UL Scan, LongDesc and ArcType fields. The rest is arbitrary.
  327.  
  328.            In  order for  Labtest to   function properly,  set UL  Scan and
  329.            LongDesc to  YES. If you want  only one archive type  for all of
  330.            your files, leave the ArcType  field empty, and Labtest will use
  331.            the setting specified by LABTEST.CFG.
  332.  
  333.            Labtest has the ability to change a user's security level and/or
  334.            flags if the uploaded file fails the virus scan. Note that other
  335.            test  failures have  no effect  on the  security level or flags,
  336.            only the virus scan portion  does. This is an extremely powerful
  337.            option as you  can prevent the user from  uploading another file
  338.            until  you contact  him about  the problem.
  339.  
  340.            Using  the flags  or min   security level  settings in  the menu
  341.            definition, you can effectively prevent  a user from uploading a
  342.            file.  For  example,  if  you  have  the  MinSec for your Upload
  343.            command set to 3, and you set Labtest to drop the security level
  344.            to 2, then the user cannot access the upload command.
  345.  
  346.            ╒══════════════════════════════════════════════════════════════╕
  347.            │░░░░░░ SUPPORT FILES ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  348.            ╘══════════════════════════════════════════════════════════════╛
  349.  
  350.            The following  is a list  of files related  to the operation  of
  351.            this program. It is noted whether  or not the file is absolutely
  352.            required in order for the program to run.
  353.  
  354.            Filename        Required  Description
  355.            ------------    --------  --------------------------------------
  356.            LABTEST.EXE       Yes     The main executable.
  357.            DOSWIN.EXE        Yes     Required for Dos Window
  358.            LABTEST.CFG       Yes     Configuration file - ascii text file
  359.            LABTEST.ANS       Yes     Screen displayed to users
  360.            LABTEST.ASC       Yes     Ascii screen display
  361.            LABTEST.CTL       Yes     Control file for output screen
  362.            COMMENT.CTL       Yes     Used when inserting archive comments
  363.            SCAN.CTL          Yes     Specifies virus scanning programs
  364.            ORDER.FRM         No      The program registration form.
  365.            LABTEST.DOC       No      The User's Manual
  366.            MANUAL.COM        No      The User's Manual in executable form
  367.            *.MSG             No      Message text files to be written to
  368.                                      the user
  369.            DJPEG.EXE         *       Required for decompressing .JPG files
  370.            CJPEG.EXE         *       Required for compressing .GIF files
  371.  
  372.            ╒══════════════════════════════════════════════════════════════╕
  373.            │░░░░░░ CUSTOMIZATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  374.            ╘══════════════════════════════════════════════════════════════╛
  375.  
  376.            Included with the distribution  archive is a sample LABTEST.RIP,
  377.            LABTEST.ANS, LABTEST.ASC and accompanying LABTEST.CTL files. You
  378.            may  use  these  stock  screens  without  modification. But most
  379.            sysops  like  to  give  their  BBS  a  personal  touch. In depth
  380.            information on how to tell Labtest  where to display text on the
  381.            screen is contained in the control file LABTEST.CTL. You can use
  382.            a drawing program like THEDRAW to change the .ANS screen. During
  383.            the processing  Labtest will use the  screen region beginning at
  384.            line 15 and  ending at line 23. This will  not effect the user's
  385.            screen, only the sysop screen.
  386.  
  387.            If you customize  your Labtest screen, please send  us a copy so
  388.            we can  include it in the  distribution archive as a  sample for
  389.            others to use.
  390.  
  391.            You  may name  the screens  and control  file anything you wish,
  392.            just be sure to put the correct name and path in the LABTEST.CFG
  393.            file. On multi-line systems, it  is possible to have a different
  394.            screen setup for each node,  just create each screen and control
  395.            file, and specify them in the appropriate LABTEST.Cxx files.
  396.  
  397.            If you plan  on converting GIF files to JPG,  you should use the
  398.            GIF2JPG.ANS/.RIP   and  GIF2JPG.CTL   files  in   place  of  the
  399.            LABTEST.ANS/.RIP/.CTL   files.   Likewise,   if   you   plan  on
  400.            decompressing .JPG  files, use the  JPG2GIF.ANS/.RIP/.CTL files.
  401.            These files have the additional text prompts so your user's know
  402.            what Labtest is doing with  the .GIF/.JPG files. Otherwise, they
  403.            will only notice a long delay, and probably drop carrier because
  404.            they may think Labtest has locked up.
  405.  
  406.            About using RIP with Labtest
  407.            ────────────────────────────────────────────────────────────────
  408.  
  409.            Labtest  will attempt  to  auto-detect  the user's  RIP graphics
  410.            capabilities. If  the user has  a RIP-capable terminal  program,
  411.            then  the  RIP  screen  specified  in  your  .CFG  file  will be
  412.            displayed.  Simultaneously, Labtest  will display  the .ANS file
  413.            specified in your  .CFG file. The Sysop will  hardly notice that
  414.            the user is using RIP  graphics. To make it somewhat discernable
  415.            from  an .ANS  caller, the  local screen  will not have blinking
  416.            colors.  This lets you know that the user is in RIP mode.
  417.  
  418.            There  are   three  sample  .RIP   screens  included  with   the
  419.            distribution archive: GIF2JPG.RIP,  JPG2GIF.RIP and LABTEST.RIP.
  420.            You may customize  these screens as you wish,  or you may create
  421.            your own. A word of caution: Due to the base 36 numbering system
  422.            used by RIP,  it is very difficult to tell  Labtest where to put
  423.            text on the  user's screen. RIP screens are  measured in pixels,
  424.            640 across, 350 top to bottom. Therefore, to tell Labtest to put
  425.            the word  'Working' at location  x,y you must  use RIP's base-36
  426.            numbering system.  The easiest way  to design a  new screen, and
  427.            tell Labtest where to put the information is as follows:
  428.  
  429.            Step 1: Create you screen. Make it  as fancy or as simple as you
  430.            want. Just leave blanks where  you want your text (i.e. Working)
  431.            to go. Make sure that all the blanks are the same size, and they
  432.            are  at least  large enough  to hold  the longest  word in  your
  433.            display (i.e. Processing is 10  characters wide). After you have
  434.            your screen perfected (which will take some practice!), save it.
  435.  
  436.            Step 2: With  your Labtest screen loaded into  your favorite RIP
  437.            painting program, set your Font  style to Default (8x8) and Font
  438.            size to x1 (normal). These are  the settings used by Labtest and
  439.            cannot  be changed.  Now, with  your prompts  in mind,  you must
  440.            place the longest  word into each of the  spaces you provided in
  441.            step 1.  The reason for this  is because the paint  program will
  442.            save  the  RIP  scrip  file  starting  with  the first thing you
  443.            painted to the  last. After you have placed a  word into each of
  444.            the  spaces, save  the file  to a  new filename (don't overwrite
  445.            your other file!).
  446.  
  447.            Step 3: Print out your  LABTEST.CTL file (or the GIF2JPG/JPG2GIF
  448.            control file).  You'll need to write  your new row/col positions
  449.            on this. Load  you favorite text editor, and  then load the .RIP
  450.            file you saved in step 2. Among other stuff, you'll see a lot of
  451.            funny looking text. Rip commands begin with a !| sequence. Go to
  452.            the bottom of  the file and try to find  the first occurrence of
  453.            the  word  that  you  placed  in  step  2  above. Look for a !|@
  454.            sequence  to the  left of  your text.  Between the  !|@ and your
  455.            word,  you will  see four   characters. The  first two  are your
  456.            Column number, and the next two  are your Row number. From here,
  457.            you would  write down the column/row  numbers that correspond to
  458.            the  keyword (or  action) that  is listed  on your  printed .CTL
  459.            file.
  460.  
  461.            If all else  fails, stick with the sample  .RIP files and you'll
  462.            be just fine!
  463.  
  464.            ╒══════════════════════════════════════════════════════════════╕
  465.            │░░░░░░ USING LABTEST ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  466.            ╘══════════════════════════════════════════════════════════════╛
  467.  
  468.            To run Labtest, you must have  a fossil driver installed. If you
  469.            want to run Labtest in local  mode, you will still need a fossil
  470.            driver, but you should use the /L switch to override the reading
  471.            of the door information file.
  472.  
  473.            Labtest will read the commandline to  fetch the file names to be
  474.            processed. Valid filenames include:
  475.  
  476.            Wildcards  (*.*,  *.ZIP,  etc..)
  477.            One or more filenames (ie C:\BBS\UPLOADS\NEWFILE.ZIP)
  478.  
  479.            You  can mix  and match  any  of  the above.  You can  even have
  480.            multiple    wildcards,   like    C:\BBS\*.*   C:\BBS\UPLOADS\*.*
  481.            C:\MODEM\DOWNLOAD\*.ARJ, etc..
  482.  
  483.            Note: When using wildcards Labtest will only process those files
  484.            that  were not  previously processed  by Labtest.  Labtest keeps
  485.            track of which files have  been already processed. You may force
  486.            Labtest to process all files  by using the /O (Override) command
  487.            line  switch.  Using  the  /O   switch  is  not  recommended  in
  488.            conjunction with a wildcard. Override is useful when rearchiving
  489.            is  not enabled  or on  single files.  Override should always be
  490.            enabled when  running Labtest on  the BBS to  gaurantee that the
  491.            file will be properly handled.
  492.  
  493.            Please  note that  Labtest will  search the  FILES.RA file for a
  494.            path matching  the path specified  on the command  line. Labtest
  495.            will expand  wildcards to a path  and wildcard. If there  was no
  496.            matching  path found  in the  FILES.RA file,  no updates will be
  497.            made  to  the  file  database.  Additionally,  if the file being
  498.            processed is not found in the  database, Labtest will not add it
  499.            to the database.
  500.  
  501.            To run Labtest  as a nightly event in  your BBS, install Labtest
  502.            in your system's event handler:
  503.  
  504.                                                      \/==Local Mode!
  505.            C:\LABTEST\LABTEST.EXE C:\BBS\UPLOADS\*.* /L
  506.  
  507.            The above line would cause Labtest to process any 'new' files in
  508.            the upload directory. (Registration removes the Press any key to
  509.            continue prompt upon loading of Labtest.)
  510.  
  511.            The above method is useful if your system recieves files through
  512.            a "front door" program.
  513.  
  514.            Imbedded archives
  515.            ────────────────────────────────────────────────────────────────
  516.  
  517.            Labtest supports  processing of imbedded  archives. For example,
  518.            if  someone uploads  a file  named TEST.ZIP  and it  has a  file
  519.            inside it  SAMPLES.ARJ, Labtest will  unpack, scan, and  convert
  520.            each  of the  internal archive  files in  the same  manner as it
  521.            processes the  base archive file. All  command line options have
  522.            effect. If  you specify /NS  for NOSCAN, internal  archives will
  523.            not be scanned either. If you specify /NR for NOREARC, they will
  524.            not be converted. Adding files  is not supported. Deleting files
  525.            from  internal   archives  is  supported.   Labtest  will  strip
  526.            internals of any archive comments if they are found and will not
  527.            add an  archive comment to  any internal archives.  Labtest will
  528.            also check the dates of  files inside internal archives. Labtest
  529.            will  ignore  any  FILE_ID.DIZ  or  DESC.SDI  files found inside
  530.            imbedded archives.
  531.  
  532.            Running Labtest in a Multi-Node Environment
  533.            ────────────────────────────────────────────────────────────────
  534.  
  535.            In RACONFIG, use the following commandline:
  536.  
  537.            C:\RA\LABTEST.EXE @ /N*N *M
  538.  
  539.            For Multi-node systems, specify the node number which Labtest is
  540.            running under by utilizing the  /N switch. The proper format for
  541.            this switch  is /N*N. This  will prevent Labtest  from unpacking
  542.            the archive file in a directory already in use by another node.
  543.  
  544.            Command Line Options
  545.            ─────────────────────────────────────────────────────────────────
  546.  
  547.            The follow is a description  of valid command line options which
  548.            you can better control Labtest's performance:
  549.  
  550.            /L           Causes  Labtest to  run in  'local' mode.  In Local
  551.                         Mode,  Labtest  will  not  attempt  to  read a door
  552.                         information file  nor will it post  messages to the
  553.                         sysop or the user.
  554.  
  555.            /O           This is the Override command. Labtest will normally
  556.                         process only those  files not previously proceseed.
  557.                         Using  this  command,  you  will  force  Labtest to
  558.                         ignore it's own time  stamp feature. This is highly
  559.                         recommended while running under  the BBS system. An
  560.                         industrious person  may determine the  special file
  561.                         stamping  and attempt  to trick  Labtest. This will
  562.                         ensure that this will never happen.
  563.  
  564.            /C           This switch forces Labtest to look in the specified
  565.                         directory  for  the   EXITINFO.BBS  file.  Example:
  566.                         /CC:\RA\NODE1. Note that this is only a path, not a
  567.                         full  filename! Proper  format for  this switch  is
  568.                         /CC:\RA\NODE*N (specify whatever path you like, use
  569.                         of the *N is optional)
  570.  
  571.            /N           Specifies   the  node   number  which   Labtest  is
  572.                         operating on.  This is extremely  important to keep
  573.                         one user's files from getting mixed up with another
  574.                         user's files. The proper  format for this switch is
  575.                         /N*N on the Labtest command line in RACONFIG.
  576.  
  577.            /D           Starts  Labtest  in  Debug  mode,  where additional
  578.                         helpful information  is written to the  log file in
  579.                         case  you  are  having  problems.  This information
  580.                         should be  forwarded to Software  Solutions in case
  581.                         you are having problems.
  582.  
  583.  
  584.            /NOSCAN      When this  command is  given, Labtest  will not run
  585.            /NS          the virus scanner on any file  during  the  current
  586.                         session.  Note this  is only  useful when  you just
  587.                         want   to  convert   your  files   to  one  format.
  588.                         Otherwise, this is not recommended.
  589.  
  590.            /NOREARC     Prevents Labtest from rearchiving files.
  591.            /NR
  592.  
  593.            /NOCOMMENT   Prevents Labtest from adding an archive comment.
  594.            /NC
  595.  
  596.            Running Labtest from RAMGR
  597.            ───────────────────────────────────────────────────────────────
  598.  
  599.            You may wish to setup one of the RAMGR function keys in RACONFIG
  600.            to run Labtest  from the File Manager. Specify  the same command
  601.            line  in RACONFIG.RAMGR.Fkeys  as you  did in  RACONFIG.SCANNER.
  602.            Then, when you are browsing through RAMGR, hit the ALT+(Fkey) to
  603.            run Labtest.  Due to some  ambiguity with RAMGR,  upon returning
  604.            from  Labtest,  it  may  appear  that  the  changes did not take
  605.            effect. However,  upon exiting RAMGR  and going to  RA, you will
  606.            notice that the changes did, in fact, take place.
  607.  
  608.            ╒══════════════════════════════════════════════════════════════╕
  609.            │░░░░░░ THE CONFIGURATION FILE ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  610.            ╘══════════════════════════════════════════════════════════════╛
  611.  
  612.            LABTEST.CFG  must  reside  in  the  directory  specified  by the
  613.            LABTEST environment variable by putting the following command in
  614.            your AUTOEXEC.BAT file:
  615.  
  616.                        SET LABTEST=C:\RA\LABTEST
  617.  
  618.  
  619.            ╒══════════════════════════════════════════════════════════════╕
  620.            │░░░░░░ NOTES FROM THE AUTHOR ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  621.            ╘══════════════════════════════════════════════════════════════╛
  622.  
  623.            Labtest is distributed  "AS IS" and no warranty  or gaurantee is
  624.            supplied. The end user accepts all responsibility for the proper
  625.            use  and  operation  of  Labtest.  Under  no  circumstances will
  626.            Software  Solutions be  held liable  for any  damages or loss of
  627.            resources either  directly or indirectly resulting  from the use
  628.            or misuse of this software.
  629.  
  630.            Technical notes
  631.            ────────────────────────────────────────────────────────────────
  632.  
  633.            Labtest  was written  entirely in  Turbo C++  version 3.0.  Door
  634.            interface routines provided by OpenDoors 4.2 by Brian Pirie.
  635.  
  636.            Labtest  detects   the  following  archivers   (SFX  where  self
  637.            extracting files  are supported. Note: ???  means not thoroughly
  638.            tested)
  639.  
  640.            Archiver     Version
  641.  
  642.            PKZIP/SFX    1.11 through 2.04g
  643.            ARJ/SFX      2.20 through 2.41
  644.            LHA/SFX      2.13
  645.            PKPAK/SFX    3.61
  646.            PKARC        3.5
  647.            LHARC        ???
  648.            ARC          ???
  649.  
  650.            Labtest  operates by  shelling to  the user  defined archive and
  651.            scanning programs. If the  archive programs return an errorlevel
  652.            of 0, Labtest assumes the operation was successful. If any other
  653.            errorlevel  is returned  by the  software, then  the archive  is
  654.            tagged  as 'bad'.  Note however  that utilities  like PKZIP will
  655.            return  an errorlevel  of non-zero  if you  did not  have enough
  656.            memory or disk space to  unpack the archive. Labtest will always
  657.            log the errorlevel  reported by an archive utility  and the scan
  658.            utility. Consult  the documentation on the  utilities you decide
  659.            to use  with Labtest for specifics  on errorlevels. Labtest will
  660.            shell once and scan the  temporary directory using the specified
  661.            scanning utilities.
  662.  
  663.            After  a file  is successfully  unpacked, scanned  and repacked,
  664.            Labtest  will  throw  in  your  ZIP/ARJ  comment  (if defined in
  665.            LABTEST.CFG).  Last but  not at  all least,  Labtest will update
  666.            RemoteAccess  2.xx  file  database  system  to  reflect  the new
  667.            changes.
  668.  
  669.            Labtest initially  renames the archive file.  If an error occurs
  670.            during  processing,  the  file  will  be  renamed  again  to its
  671.            original name for further inspection by the Sysop.
  672.  
  673.            Notes on Secured Archives
  674.            ────────────────────────────────────────────────────────────────
  675.  
  676.            PKZip  and ARJ  archive utilities  have the  ability to stamp an
  677.            archive  file  with  a  special  code  protecting it from future
  678.            changes. Labtest detects these  'archive stamps' and will either
  679.            ignore them or honor them, depending  on how you have the option
  680.            set in LABTEST.CFG.
  681.  
  682.            ────────────────────────────────────────────────────────────────
  683.  
  684.            Software Solutions BBS is the official support site for Labtest.
  685.            All  future versions  of Labtest  will be  available on Software
  686.            Solutions BBS.
  687.  
  688.            Labtest may be  file requested (freq'd) by using  the magic name
  689.            LABTEST  or you  may log  onto the  BBS and  download the latest
  690.            version.
  691.  
  692.            Additionally, if you  are running Fido Net mail,  you may set up
  693.            your system for the Labtest echo, originating from 1:214/54. Tag
  694.            name is  LABTEST. Send a  netmail message to  1:214/54, indicate
  695.            your password  and archive preference. Your  system will then be
  696.            placed on the  export list. From there, just  poll us and you'll
  697.            get the latest tips, user comments and suggestions. It's also an
  698.            excellent way to keep in touch with us and Labtest users.
  699.  
  700.            Software Solutions
  701.            1:214/54
  702.            BBS:  (209)997-0224
  703.            PO Box 1233
  704.            Lemoore, CA 93245-1233
  705.  
  706.