home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / LBTST30A.ZIP / LABTEST.DOC < prev    next >
Text File  |  1994-06-01  |  65KB  |  1,583 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                    ┌─┐  ┌──────┌──────┌─────┌─────┌─────┌─────┐
  14.                    │ │  │ ┌──┐ └┐ ┌─┐ ├─┐ ┌─│ ┌───│ ┌───└─┐ ┌─┘
  15.                    │ │  │ └──┘  │ └─┘ │ │ │ │ └─┐ │ └───┐ │ │
  16.                    │ │  │ ┌──┐  │ ┌─┐ │ │ │ │ ┌─┘ └───┐ │ │ │
  17.                    │ └──│ │  │ ┌┘ └─┘ │ │ │ │ └───┌───┘ │ │ │
  18.                    └────└─┘  └─└──────┘ └─┘ └─────└─────┘ └─┘
  19.  
  20.                                   Version 3.0
  21.  
  22.                       Copyright (c) 1993-94 by Mark Williamson
  23.  
  24. >          This documentation file has  been re-written and the information
  25. >          contained herein only applies to version 3.0 and above.
  26.  
  27.            ╒══════════════════════════════════════════════════════════════╕
  28.            │░░░░░░ LEGAL STUFF ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  29.            ╘══════════════════════════════════════════════════════════════╛
  30.  
  31.            The Graphics Interchange Format(c) is the Copyright property of
  32.            CompuServe Incorporated.  GIF(sm) is a Service  Mark property of
  33.            CompuServe Incorporated.
  34.  
  35.            This product uses the JAM(mbp)  API - Copyright (c) 1993 Joaquim
  36.            Homrighausen, Andrew Milner, Mats Birch, Mats Wallin. ALL RIGHTS
  37.            RESERVED.
  38.  
  39.            This  product uses  the  RIPscrip  language, Copyright  (c) 1993
  40.            Telegrafix Communications, Inc.
  41.  
  42.            RemoteAccess, RACONFIG,  RAMGR and RA  are copyrighted (c)  1993
  43.            Andrew Milner
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.            ╒══════════════════════════════════════════════════════════════╕
  71.            │░░░░░░ TABLE OF CONTENTS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  72.            ╘══════════════════════════════════════════════════════════════╛
  73.  
  74.            Licensing information......................................... 1
  75.  
  76.            Introduction.................................................. 2
  77.  
  78.            Installation.................................................. 3
  79.  
  80.               Environment variables...................................... 3
  81.                  RA environment variable................................. 3
  82.                  Labtest environment variable............................ 3
  83.  
  84.            Configuration................................................. 4
  85.  
  86.               Files/Paths................................................ 4
  87.                  Log file path........................................... 4
  88.                  Swap directory.......................................... 4
  89.                  Bad files directory..................................... 4
  90.                  ANSI screen............................................. 4
  91.                  ASCII screen............................................ 4
  92.                  RIP screen.............................................. 5
  93.                  Screen control file..................................... 5
  94.                  Add files list.......................................... 5
  95.                  Kill files list......................................... 5
  96.                  Page file............................................... 5
  97.                  Hack Report file........................................ 5
  98.                  Archive comment file.................................... 5
  99.  
  100.               Messages................................................... 6
  101.                  Sysop message board..................................... 6
  102.                  User message board...................................... 6
  103.                  Thank you message....................................... 6
  104.                  Virus message........................................... 6
  105.                  Bad file message........................................ 6
  106.                  Old file message........................................ 7
  107.                  Bad GIF message......................................... 7
  108.                  Hack report message..................................... 7
  109.                  Sysop messages.......................................... 7
  110.                  File description notes.................................. 7
  111.  
  112.               Options.................................................... 7
  113.                  Registration Key........................................ 7
  114.                  Maximum file age........................................ 7
  115.                  Set security level...................................... 7
  116.                  Set user flags.......................................... 7
  117.                  Add uploader name....................................... 7
  118.                  Sound virus alarm....................................... 8
  119. >                Remote Status Window.................................... 8
  120.  
  121.                  Gif file options........................................ 8
  122.                     Minimum width........................................ 8
  123.                     Minimum height....................................... 8
  124.                     Minimum colors....................................... 8
  125.                     Separator character.................................. 8
  126.                     Compress GIF files................................... 8
  127.                     Uncompress JPG files................................. 9
  128.  
  129.  
  130.  
  131.                                           i
  132.  
  133.  
  134.  
  135.  
  136.  
  137.                  Archive file options.................................... 8
  138.                     Default archive type................................. 8
  139.                     Number of old files.................................. 9
  140.                     File date options.................................... 9
  141.                     Convert SFX files.................................... 9
  142.                     Pack unknown files................................... 9
  143.                     Keep archive security................................ 9
  144.                     Imbedded archives.................................... 9
  145.                     Process descriptions................................. 9
  146.                     Maximum file size.................................... 9
  147.                     Adjust user credit...................................10
  148.                     Failed scan action...................................10
  149.  
  150.                     Archiver setup.......................................10
  151.                        Extension.........................................10
  152.                        Unpack command....................................10
  153.                        Pack command......................................10
  154.                        Comment command...................................10
  155.                        Memory required...................................11
  156.                        Use dos window....................................11
  157.  
  158.                     Virus scanner setup..................................11
  159.                        Scan command line.................................11
  160.                        Memory required...................................11
  161.                        Use dos window....................................11
  162. >                      Errorlevel........................................12
  163.  
  164.               FILES.RA...................................................12
  165.                  File area path..........................................12
  166.                  Default archive type....................................12
  167.                  Long descriptions.......................................12
  168.  
  169.               MESSAGES.RA................................................12
  170.                  Sysop message board type/JAMbase path...................12
  171.                  User message board type/JAMbase path....................12
  172.  
  173.               CONFIG.RA..................................................12
  174.                  Multi-line..............................................12
  175.                  Hudson message base path................................13
  176.                  Sysop name..............................................13
  177.                  System name.............................................13
  178.                  Upload scan.............................................13
  179.  
  180.            Running Labtest...............................................13
  181.  
  182.               Command line options.......................................13
  183.                  /L Local................................................13
  184.                  /O Override.............................................13
  185.                  /C Exitinfo.bbs path....................................13
  186.                  /N Node number..........................................13
  187.                  /NS No scanning.........................................13
  188.                  /NR No converting.......................................13
  189.                  /NC No commenting.......................................14
  190.                  Processing file areas...................................14
  191.                  Processing wildcards....................................14
  192.               Online.....................................................14
  193.               RAMGR......................................................14
  194.               With OS/2 and Desqview.....................................15
  195.  
  196.  
  197.  
  198.                                          ii
  199.  
  200.  
  201.  
  202.  
  203.  
  204.            Customization.................................................15
  205.               ANSI screen................................................15
  206.               RIP screen.................................................15
  207.  
  208.            Support files.................................................16
  209.  
  210.            External program errorlevels..................................17
  211.  
  212.            How to contact the author.....................................19
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.                                           iii
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.            ╒══════════════════════════════════════════════════════════════╕
  271.            │░░░░░░ LICENSING INFORMATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  272.            ╘══════════════════════════════════════════════════════════════╛
  273.  
  274.            This program is  not Freeware. This is SHAREWARE  which means it
  275.            is  user-supported software.  If you  use this  program for more
  276.            than 30  days, you are  required to register  or remove it  from
  277.            your system.
  278.  
  279.            The concept works  only with your support. If  you find that you
  280.            can  use this  program, then  a registration  fee of $20.00 U.S.
  281.            funds will  help defray the  development cost and  encourage the
  282.            authorship  of other  programs that  might be  useful to  you. A
  283.            Registration  Form  for  this   purpose  is  included  with  the
  284.            distribution archive and is called ORDER.FRM.
  285.  
  286.            Labtest is Copyrighted (c) 1993 - 1994 by Mark Williamson and all
  287.            rights are reserved. You may copy this program and documentation
  288.            for  backup purposes.  You also  may copy  and share  UNMODIFIED
  289.            copies  of the  program  package,  providing that  the copyright
  290.            notice is reproduced and included on all copies.
  291.  
  292.            You may  not sell the  product for a  fee and/or distribute  the
  293.            product  along  with  other  products  without expressed written
  294.            permission from Software Solutions, nor may you modify or remove
  295.            the Copyright Notice from the  program, the documentation or the
  296.            display screens.
  297.  
  298.            Those who register  this program within one year  of its release
  299.            by the author, will receive a registration key. The key will  be
  300.            delivered either by personal  upload, netmail or postal service.
  301.            Allow up to 6 weeks for delivery.
  302.  
  303.            This  program is  not guaranteed  to do  anything except take up
  304.            hard  disk space.
  305.  
  306.            Comments, suggestions  and bug reports are  welcome. If you have
  307.            any, you should contact Mark Williamson at Fidonet 1:214/53.
  308.  
  309.            If  you're  reporting  a  bug,  please  give  as  much detail as
  310.            possible about the  problem you are experiencing so  that it can
  311.            be duplicated  and fixed. Please also  include information about
  312.            the platform Labtest is running on.
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.                                           1
  333.  
  334.  
  335.  
  336.  
  337.            ╒══════════════════════════════════════════════════════════════╕
  338.            │░░░░░░ INTRODUCTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  339.            ╘══════════════════════════════════════════════════════════════╛
  340.  
  341.            Labtest  was initially  developed as  a non-BBS  tool I  used to
  342.            process my files which I downloaded  from BBS's. When I became a
  343.            Sysop,  I  decided  that  I  needed  an  upload scanner. Thus, I
  344.            commenced  work on  Labtest. Originally,  as an  upload scanner,
  345.            Labtest was  not specific to  any one BBS  program. That created
  346.            severe problems  for me, so I  chose to limit my  efforts to the
  347.            RemoteAccess community.
  348.  
  349.            Labtest started life as  version 2.00v1. Then quickly progressed
  350.            through numerous  stages, albeit some were  very painful. In its
  351.            current state,  as version 3.0, Labtest  represents a great deal
  352.            of research, bug-hunting, and  an appreciable amount of patience
  353.            on the part of the Sysops out there using the program.
  354.  
  355.            Labtest  is  written  with  Borland C++ 3.1, using the OpenDoors
  356.            library by Bryan Pirie.
  357.  
  358.            Although there are  no guarantees that you will  have success at
  359.            setting up and using Labtest,  I have gone through great lengths
  360.            to make the configuration easy.  If you have any recommendations
  361.            or possible  bugs to report,  please see the  last page of  this
  362.            documentation for ways you can get a hold of the author.
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.                                           2
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.            ╒══════════════════════════════════════════════════════════════╕
  405.            │░░░░░░ INSTALLATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  406.            ╘══════════════════════════════════════════════════════════════╛
  407.  
  408.            Installation of Labtest is  relatively simple. You should create
  409.            a directory  especially for  Labtest  or  place the  program and
  410.            support  files  in  your   RemoteAccess  system  directory.  The
  411.            location of  Labtest is unimportant. To  install Labtest, unpack
  412. >          the  distribution archive  into your  desired directory. Changed
  413. >          from  previous versions,  you no  longer need  to have a LABTEST
  414. >          environment variable.  Instead, put Labtest in  your DOS Path so
  415. >          that  you may  run it  from any  directory on  your system,  and
  416. >          Labtest will  find its files  by searching the  path.
  417.  
  418.            If you are  running a multi-node system, you  have the option of
  419.            having a different configuration file  for each node your system
  420.            runs. To  create a config  file for each  of your nodes,  simply
  421.            copy the LABTEST.CFG  file to LABTEST.Cnn, where nn  is the node
  422.            number,  1 being  node 1  and so  one. Do  not place any leading
  423.            zeros  in  the  node  number.  For  example,  LABTEST.C1  is the
  424.            configuration   file   for   node   1.   Using  this  multi-file
  425.            configuration,  you  can  further  customize  Labtest  for  your
  426.            system.  Labtest  will  look  for   the file  LABTEST.Cnn first,
  427.            then, LABTEST.CFG.
  428.  
  429.            ╒══════════════════════════════════════════════════════════════╕
  430.            │░░░░░░ ENVIRONMENT VARIABLES ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  431.            ╘══════════════════════════════════════════════════════════════╛
  432.  
  433. >          It is no longer required  to have a LABTEST environment variable
  434. >          set, since  Labtest now searches your  DOS PATH for LABTEST.EXE,
  435. >          and expects to find its associated files in this directory.
  436.  
  437.            Ensure  you have  your RA environment variable  set. Include the
  438.            following commands in your AUTOEXEC.BAT file:
  439.  
  440.            SET RA=<path>
  441.  
  442.            where <path> is  the drive and path for your  RA. Do not include
  443.            an ending backslash '\'.
  444.  
  445.            It  is also  recommended that  you add  the Labtest directory to
  446.            your DOS PATH statement, so you can run Labtest from anywhere on
  447.            your computer.
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.                                           3
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.            ╒══════════════════════════════════════════════════════════════╕
  472.            │░░░░░░ CONFIGURATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  473.            ╘══════════════════════════════════════════════════════════════╛
  474.  
  475. >          With the release of version 3.0  comes a new setup program which
  476. >          will read your CONFIG.RA file  and adopt much of the information
  477. >          needed  by  Labtest  and  store  it  in your configuration file.
  478. >          Labtest 3.0 no longer uses a text configuration file so you will
  479. >          not be able to modify it  with a text editor. Labtest uses other
  480. >          information from your FILES.RA and MESSAGES.RA files as well. To
  481. >          ensure that changes made in your *.RA files is reflected in your
  482. >          configuration file, it is recommended to run LTSetup  after  you
  483. >          make changes to any of your *.RA files.
  484.  
  485.            When you  load the Setup program,  you will be presented  with a
  486.            pull  down menu  that  has  four possible  choices: Files/Paths,
  487.            Messages,  Options,  and  Quit.  Each  menu  selection  and  the
  488.            submenus it contains will be described below:
  489.  
  490.            All prompts  and log file text  used by Labtest and  LtSetup are
  491.            contained in an ASCII text  file called LABTEST.LNG. It has been
  492.            provided in ASCII format so  that international users can easily
  493.            modify  the prompts  for their  native language.  Note that  the
  494.            order of  the prompts is  extremely important and  should not be
  495.            changed. Additionally, no prompt can  be more than 80 characters
  496.            wide. The LABTEST.LNG file must be located in the same directory
  497.            as  LABTEST.EXE  and  LTSETUP.EXE.  Several  <reserved>  prompts
  498.            appear  between the  LTSETUP prompts  and the  LABTEST text. You
  499.            MUST not remove  any of these as it will  throw off the order of
  500.            the remaining prompts.
  501.  
  502.            ╒══════════════════════════════════════════════════════════════╕
  503.            │░░░░░░ FILES AND PATHS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  504.            ╘══════════════════════════════════════════════════════════════╛
  505.  
  506.            This  menu contains  the bulk  of the  filenames and  paths that
  507.            control  where Labtest  will store  some items  and where it can
  508.            find special control files and screen display files.
  509.  
  510.            Log File  Path: This is  a drive and  path where Labtest  should
  511.            write the  LABTEST.LOG and UPLOAD.LOG files.  The actual name of
  512.            these files depends on your whether you are running a multi-line
  513.            system or not.
  514.  
  515.            Swap  path:  Specify  a  complete  drive  and path where Labtest
  516.            should  store its  temporary swap  file when  executing external
  517.            programs.
  518.  
  519.            Bad files path: Specify the full drive and path of where Labtest
  520.            should place files which are failed  by Labtest. If this path is
  521.            defined in your FILES.RA, the database will also be updated.
  522.  
  523.            Ansi screen: Specify a full path and filename of the .ANS screen
  524.            Labtest should  display to your  ANSI callers when  processing a
  525.            file. This screen will also be used for the local display.
  526.  
  527.            Ascii  screen: Specify  a full   path and  filename of  the .ASC
  528.            screen  file to  display to  callers not  supporting RIP or ANSI
  529.            graphics.
  530.  
  531.  
  532.                                           4
  533.  
  534.  
  535.  
  536.  
  537.  
  538.            Rip screen: Specify a full path  and filename of the .RIP screen
  539.            file to display to callers supporting RIP graphics. Labtest will
  540.            display the  .ANS screen on the  local terminal while displaying
  541.            RIP graphics to the remote caller.
  542.  
  543.            Screen control file:  Specify the full path and  filename of the
  544.            .CTL file which Labtest will  use when displaying information to
  545.            the  screen.  This  control  file  contains  information such as
  546.            colors,  coordinates  and  text   to  be  displayed  during  the
  547.            processing. This file is required!
  548.  
  549.            Add file list: While not a  popular thing to do, Labtest can add
  550.            files to an archive. Specify here  the full path and filename of
  551.            your  add file  list. This  file should  contain full  paths and
  552.            filenames, one per line, of files you want added to EACH archive
  553.            processed. Labtest only adds these files to the BASE archive and
  554.            never adds them to the imbedded archives.
  555.  
  556.            Kill file  list: This is  the opposite of  the above. This  file
  557.            should contain filenames (or wildcards)  of files you wish to be
  558.            removed from  EACH archive and  imbedded archives. For  example,
  559.            specifying RUSTY.*  will remove all  files that match  this file
  560.            mask.
  561.  
  562.            Page  file:   Specify  the  full   path  and  filename   of  the
  563.            RemoteAccess compatible page file Labtest  should use as a virus
  564.            alarm. This is  ignored if you set Sound  Alarm to No (described
  565.            later)  or if  you have  the Scroll  Lock key  on. See  the file
  566.            PAGE.LAB in the distribution archive.
  567.  
  568.            Hack report file: Specify the full path and filename of the HACK
  569.            .COL  or  .IDX  file  Labtest  should  search.  This file should
  570.            contain base file names of files you do not want on your system.
  571.            Do not include  the file extension. Labtest is  fully capable of
  572.            reading and parsing the Hack  Report .IDX and .COL files without
  573.            modification.
  574.  
  575.            Archive comment  file: This is the  full path and filename  of a
  576.            text  file you  want added  as an  archive comment  to each file
  577.            Labtest  processes.  If  you  do  not  want ANY archive comments
  578.            added, leave this field blank.  See also the Archive Definitions
  579.            menu  under  the  Comment  field.  You  may  optionally  add the
  580.            contents of the FILE_ID.DIZ as an archive comment.
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.                                           5
  600.  
  601.  
  602.  
  603.  
  604.  
  605.            ╒══════════════════════════════════════════════════════════════╕
  606.            │░░░░░░ MESSAGES TO USER/SYSOP ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  607.            ╘══════════════════════════════════════════════════════════════╛
  608.  
  609.            In the distribution archive you should find several *.MSG files.
  610.            These files contain text which  will be imported by Labtest into
  611.            the message  base. These messages  may be totally  customized by
  612.            you to give your system a personal touch. There are a few macros
  613.            which will be expanded by  Labtest during reading of the message
  614.            file.  These are explained below:
  615.  
  616.                @SYSOP@          Sysop name (as defined in RACONFIG)
  617.                @BBS@            BBS system name (RACONFIG)
  618.                @USERFIRST@      First name of the user
  619.                @UPLOADS@        Total number of uploads the user has posted
  620.                @UPLOADK@        Uploads (in K) the user has posted
  621.                @AGE@            Maximum age in years for files
  622.                @GIFRESOLUTION@  Minimum acceptable GIF resolution
  623.                @UPLOADFILE@     The name of the uploaded file.
  624.                @VIRUSINFO@      Labtest will insert specific information
  625.                                 about  the  virus  detected  (if any). Used
  626.                                 *ONLY* in the VIRUS.MSG file.
  627.  
  628.            Keep  in mind  the width of each  of these  macros when they are
  629.            expanded. Labtest  will not word wrap  the text and it  may look
  630.            choppy if your text lines are too long.
  631.  
  632.            ╒══════════════════════════════════════════════════════════════╕
  633.            │░░░░░░ MESSAGES ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  634.            ╘══════════════════════════════════════════════════════════════╛
  635.  
  636.            This  menu controls  how Labtest  should write  messages to  the
  637.            Sysop  and to  the User  as well  as writing  notes to  the file
  638.            description.
  639.  
  640.            Sysop  message board:  Specify  the  message board  number where
  641.            Labtest should  write messages to  the Sysop concerning  various
  642.            stages of the process. Specify 0 if you do not want ANY messages
  643.            written to the Sysop.
  644.  
  645.            User  message  board:  Specify  the  message  board number where
  646.            Labtest  should  write  messages  to  the  user  concerning  the
  647.            uploaded file. Specify 0 if you do not want ANY messages written
  648.            to the User.
  649.  
  650.            Thank  you message:  Specify the  full path  and filename of the
  651.            file to be imported thanking the user for the upload.
  652.  
  653.            Virus message: Specify the full path and filename of the file to
  654.            be imported  informing the User  that the file  failed the virus
  655.            scan.
  656.  
  657.            Bad file message: Specify the full path and filename of the file
  658.            to be  imported informing the  User that the  file could not  be
  659.            processed by Labtest.
  660.  
  661.            Old file message: Specify the full path and filename of the file
  662.            to be imported  informing the User that the  file failed the age
  663.            test.
  664.  
  665.  
  666.                                           6
  667.  
  668.  
  669.  
  670.  
  671.  
  672.            Bad gif message: Specify the full  path and filename of the file
  673.            to be imported informing the User  that the .GIF file failed the
  674.            resolution test.
  675.  
  676.            Hack report message:  Specify the full path and  filename of the
  677.            file to be  imported informing the User that  the file was found
  678.            among those listed in the Hack report.
  679.  
  680.            Note: If you do not want a specific message to be written to the
  681.            user, do not  specify a path or filename  for that message file.
  682.            It is important  to adhere to this rule due  to the way messages
  683.            are written by Labtest.
  684.  
  685.            Sysop  messages: Labtest  will write  a short  note to the Sysop
  686.            concerning the status of the file. You may turn on or off any of
  687.            these messages by  selecting Yes or No at  the appropriate Sysop
  688.            Message menu prompt.
  689.  
  690.            File  comments: Labtest  will append  a short  note to  the file
  691.            description concerning the  status of the file. You  may turn on
  692.            or  off  any  of  these  notes  by  selecting  Yes  or No at the
  693.            appropriate File Comments menu prompt.
  694.  
  695.            ╒══════════════════════════════════════════════════════════════╕
  696.            │░░░░░░ OPTIONS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  697.            ╘══════════════════════════════════════════════════════════════╛
  698.  
  699.            This menu controls the overall performance of Labtest.
  700.  
  701.            Registration key: Enter your personal registration number. Enter
  702.            0 if you have not registered.
  703.  
  704.            Max  file age  (years): Specify  in years  the maximum desirable
  705.            file age. Labtest will fail files older than this.
  706.  
  707.            Set security level: Labtest can  lower the user's security level
  708.            if they upload a file containing a virus. Note that the security
  709.            level  is  ONLY  affected  if  the  file  fails the actual virus
  710.            scanning  stage. Security  level is  not affected  by any  other
  711.            process.  Specify 0  if you  do not  want Labtest  to modify the
  712.            user's security level.
  713.  
  714.            Set user  flag: Specify the flag  and status to set  if the file
  715.            fails  the virus  scan. The   same applies  as for  set security
  716.            level. For example, A1 ON would  cause Labtest to set flag A1 to
  717.            ON if a  file fails the virus scan stage.  Leave blank if you do
  718.            not want Labtest to modify the user's flags.
  719.  
  720.            Using  the  flags  or  set  security  level  settings,  you  can
  721.            effectively prevent  a user from uploading  a file. For example,
  722.            if you have the MinSec for your Upload command set to 3, and you
  723.            set  Labtest to  drop the  security level  to 2,  then the  user
  724.            cannot access the upload command.
  725.  
  726.            Add  uploader  name:  Specify  whether  Labtest  should  add the
  727.            uploader's  name to  the  file  description. Labtest  will write
  728.            'Uploaded by: <name>' at the end of the file description if this
  729.            is set to Yes.
  730.  
  731.  
  732.  
  733.  
  734.                                           7
  735.  
  736.  
  737.  
  738.  
  739.            Sound virus alarm: Specify Yes if  you want Labtest to alert you
  740.            (using the Page  file), in the event a virus  is detected in the
  741.            user's upload.
  742.  
  743. >          Remote Status Window: Labtest displays  a small status window at
  744. >          the  bottom of  the sysop's  screen. You  may also  display this
  745. >          window to your  users by setting this option  to Yes. The status
  746. >          window displays  a great more  information about the  file being
  747. >          tested.
  748.  
  749.            Gif file options
  750.  
  751.            The following only apply to .GIF or .JPG files:
  752.  
  753.            Check GIF age:  Specify whether you would like  Labtest to check
  754.            the  age of  GIF files  according to  the Max.  File Age setting
  755.            (described above).
  756.  
  757.            Min. Gif Width: Enter the minimum acceptable width in pixels for
  758.            .GIF and .JPG files.
  759.  
  760.            Min. Gif  Height: Enter the minimum  acceptable height in pixels
  761.            for .GIF and .JPG files.
  762.  
  763.            Min. Gif  Colors: Enter the minimum  acceptable number of colors
  764.            for .GIF and .JPG files.
  765.  
  766.            Note:  There is  no set  standard for  JPEG files and resolution
  767.            checking is sort of hit and miss with these files.
  768.  
  769.            GIF  separator  character:  Labtest  will  write  the  GIF color
  770.            resolution to the file description  in the format width X height
  771.            X colors. The  separator character is the  character you want to
  772.            be put in  between each of the resolution  factors. For example,
  773.            if you  specify * as  the separator, your  GIF descriptions will
  774.            look like this:  640*480*256.
  775.  
  776.            Compress GIF  files: Labtest can  compress a GIF  file using the
  777.            compression  program  specified  in  Archive  Definitions if you
  778.            specify  Yes here.  Compressing GIF  files may  save you a large
  779.            amount of disk space, at the cost of a (generally low) degree of
  780.            resolution loss. Alternatively, you can choose to Uncompress JPG
  781.            files as well.
  782.  
  783.            Uncompress JPG files: If Labtest detects a JPG file (essentially
  784.            a compressed  GIF),  it  may  be  able  to  uncompress the file,
  785.            restoring it  to GIF. Specify Yes  here if you wish  to do this.
  786.            Restoring  JPG files  will not  restore them  to their  original
  787.            resolution.  JPEG compression  is  not  a loss-less  method, and
  788.            compressed files suffer somewhat in their resolution.
  789.  
  790.            Archive file options:
  791.  
  792.            This menu contains all the necessary info for Labtest to process
  793.            archived files.
  794.  
  795.            Default archive type: Specify the  three letter extension of the
  796.            default  archive  format.  This  is  overriden  by your FILES.RA
  797.            default archive  format. If you prefer  all your files to  be of
  798.            the same type, you may leave  the default archive field blank in
  799.            all of your file areas, and specify it here instead.
  800.  
  801.                                           8
  802.  
  803.  
  804.  
  805.  
  806.            No. of old files: Specify the  minimum number of files that fail
  807.            the  Max  file  age  before  the  whole  archive  is failed. For
  808.            example,  you may  want the  archive to  be failed  after 10 old
  809.            files are found.
  810.  
  811.            File date  options: Labtest will  date the archive  according to
  812.            one of the following:
  813.  
  814.                Newest  file: The  date of  the newest  file is  used as the
  815.                archive date.
  816.  
  817.                Oldest  file: The  archive is  stamped with  the date of the
  818.                oldest file.
  819.  
  820.                Keep  date:  Labtest  will  keep  the  original  date of the
  821.                archive.
  822.  
  823.                System date: Labtest will date  the archive with the current
  824.                system date.
  825.  
  826.            Convert SFX  files: If the uploaded  file is determined to  be a
  827.            self extracting file, Labtest can either unpack/scan/convert the
  828.            file  or ignore  it altogether.  If you  set this  option to No,
  829.            Labtest will archive the file  in your default archive type. For
  830.            example, if a  user uploaded LABTST29.EXE which is  an SFX file,
  831.            and  you had  this set  to No,  Labtest will  create an  archive
  832.            called LABTST29.ARJ (assuming ARJ is your default archive type),
  833.            containing just one file, LABTST29.EXE.
  834.  
  835.            Pack unknown files:  If Labtest is unable to  determine the file
  836.            type, it can compress it  using the default archive format. This
  837.            will  save space  on your  computer if  users upload  large text
  838.            files in an effort to steal  upload credits. Specify No to leave
  839.            unknown files in their original state.
  840.  
  841.            Keep  security:  Labtest  can  detect  and  honor  the  security
  842.            envelopes of ARJ and ZIP files. If you specify Yes here, Labtest
  843.            will unpack and  scan the files, but will  not attempt to repack
  844.            or  add  a  comment  to  these  files.  This applies to imbedded
  845.            archives as well.
  846.  
  847.            Imbedded  archives:  Here  you  may  specify  how Labtest should
  848.            handle imbedded archives. The options are described below:
  849.  
  850.                Ignore: Do nothing to imbedded archives.
  851.  
  852.                Scan: Scan imbedded archives. Do not rearchive them.
  853.  
  854.                Rearc: Rearchive imbedded archives. Do not scan them.
  855.  
  856.                Scan/Rearc: Scan and rearchive imbedded archives.
  857.  
  858.            Process descriptions:  Labtest can modify  the description found
  859.            in the FILE_ID.DIZ (or DESC.SDI) file. The purpose of this is to
  860.            remove high  ascii characters such  as those used  for boxes and
  861.            special characters.
  862.  
  863.            Max. file  size: You may  define the largest  file size in  kilo
  864.            bytes  that Labtest  should attempt  to handle.  Files exceeding
  865.            this size  are ignored. This  applies only to  archive files and
  866.            not .GIF/.JPG files.
  867.  
  868.                                           9
  869.  
  870.  
  871.  
  872.  
  873.            Adjust user credit: Specify if  you would like Labtest to adjust
  874.            the user's upload credit for the new file size after conversion.
  875.            This  prevents crafty  individuals from  being overcredited  for
  876.            junk files.
  877.  
  878.            Failed  scan action:  Here you  will specify  the action Labtest
  879.            should  take on  files that  fail the  overall processing.  Each
  880.            option is described below:
  881.  
  882.               None:  Labtest will  not do  anything in  the event  of virus
  883.               detection.
  884.  
  885.               Unlisted: Labtest will mark the file as unlisted in your file
  886.               database.
  887.  
  888.               Not available: Labtest will mark the file as not available.
  889.  
  890.               Mark Deleted: Labtest will mark the file as deleted.
  891.  
  892.               Move:  Labtest will  move the  file to  the path specified in
  893.               Files/Paths - Bad file path.
  894.  
  895.               Move/Unlisted: Labtest will move and mark the file unlisted.
  896.               Move/Notavail:  Labtest  will  move  and  mark  the  file not
  897.               available.
  898.  
  899.            Archiver setup
  900.  
  901.            This menu contains the information needed by Labtest to run your
  902.            external archive utilities. Setup  is preconfigured for the more
  903.            popular archive utilities and associated command lines. However,
  904.            you  may change  these as  you wish.  The following  information
  905.            pertains to the Archiver Setup menu:
  906.  
  907.            Extension:  This  is  the  three  letter  file extension used by
  908.            the archive utility.
  909.  
  910.            Unpack command line: This is the command line (path is optional)
  911.            that  will  be  executed  by  Labtest  to unpack, or decompress,
  912.            files of this type. You should specify the program name, command
  913.            line  options, and  the @  character which  will be  replaced by
  914.  
  915.            Labtest  with the  filename. The  @ character  should be  in the
  916.            correct  position in the command line, just as you would execute
  917.            it from DOS.
  918.  
  919.            Pack command line:  This is the command line  (path is optional)
  920.            that will be executed by Labtest  to pack, or compress, files of
  921.            this  type. You  should specify  the program  name, command line
  922.            options, and the  @ character which will be  replaced by Labtest
  923.            with the filename.  The  @  character  should  be in the correct
  924.            position in the command line, just  as you would execute it from
  925.            DOS.
  926.  
  927.            Comment  command  line:  This  is  the  command  line  (path  is
  928.            optional)  that will  be executed  by Labtest  to add an archive
  929.            comment to archives of this type. You should specify the program
  930.            name, command  line options, and  the @ character  which will be
  931.            replaced by Labtest with the filename. The @ character should be
  932.            in the correct position in the command line,  just as you  would
  933.            execute it from DOS.
  934.  
  935.                                          10
  936.  
  937.  
  938.  
  939.  
  940.            MemReq  (memory required):  This is  the number  of kilobytes of
  941.            memory Labtest should set aside  for archivers of this type. The
  942.            default is 400k.
  943.  
  944.            Labtest may be configured to  convert GIF(sm) files to JPG files
  945.            or  vice  versa.  Two  programs,  CJPEG.EXE  (Compress JPEG) and
  946.            DJPEG.EXE  (Decompress  JPEG),  are  supplied  with  the Labtest
  947.            distribution archive.
  948.  
  949.            Use dos window:  Specify yes if this archiver can be used within
  950.            the dos window. You also have the option of using an 'invisible'
  951.            dos window,  which doesn't allow the  archive utility to display
  952.            any text at all, preserving the sysop's screen entirely.
  953.  
  954.            If  you plan  on converting  GIF/JPG files,  you should  see the
  955.            settings  under Gif  File  Options  for setting  the appropriate
  956.            switches.
  957.  
  958.            DJPEG will  uncompress a JPEG  file, resulting in  like-original
  959.            image quality. It is important to  note here that DJPEG will NOT
  960.            decompress   a  file   compressed  with   GIF2JPG.EXE.  However,
  961.            JPG2GIF.EXE  will  properly  handle  a  JPG  file  compressed by
  962.            CJPEG.EXE.
  963.  
  964.            You must make sure the file  areas are set up correctly. Labtest
  965.            will  look  in  FILES.RA  for  your  preferred  archive type. If
  966.            nothing is defined  there, Labtest will default to  the type set
  967.            in LABTEST.CFG. The important pieces of information here are the
  968.            LongDesc, File path and  ArcType fields. The rest is arbitrary.
  969.  
  970.            If you want  only one archive type for all  of your files, leave
  971.            the  ArcType  field  empty,  and  Labtest  will  use the setting
  972.            specified by LABTEST.CFG.
  973.  
  974.            Virus Scanner Setup
  975.  
  976.            Labtest can be  configured to run up to  20 virus scanners, each
  977.            one right  after another, on  each uploaded file.  Since version
  978.            3.0 no  longer uses the  SCAN.CTL file, you  must configure your
  979.            upload scanners in LTSETUP.
  980.  
  981.            Scan command  line: Specify the virus  scanner and command line.
  982.            You do  not need to  specify a complete  path. If you  are using
  983.            McAfee's  SCAN.EXE  or  NETSCAN.EXE,  Labtest  can determine the
  984.            actual name  of the virus  as reported by  Scan. To enable  this
  985.            option, specify  /REPORT $REPORT$ option  on your command  line.
  986.            The /REPORT tells Scan to create  a report file and the $REPORT$
  987.            is a  macro used by  Labtest. If you  use /REPORT, you  must use
  988.            $REPORT$ or  Labtest will not  read the results  from the report
  989.            file that Scan creates.
  990.  
  991.            Memory required: This is the  number of kilobytes Labtest should
  992.            set aside  for this virus scanner.  If this amount of  memory is
  993.            available when  Labtest executes the  program, Labtest will  not
  994.            swap out of memory.
  995.  
  996.            Use Dos  Window: Specify Yes  if this virus  scanner can be  run
  997.            within  the  dos  window.  Some  virus  scanners, like Microsoft
  998.            Antivirus, do not  work well in the dos  window. As mentioned in
  999.            the Archiver  Setup section, you may  specify 'invisible' if you
  1000.  
  1001.  
  1002.                                          11
  1003.  
  1004.  
  1005.  
  1006.  
  1007.            want  your  sysop  screen  preserved  entirely,  preventing  the
  1008.            scanner from displaying any output at all.
  1009.  
  1010.            Errorlevel:  Specify the errorlevel returned by this scanner if
  1011.            and only if a virus is detected.  This avoids  a  problem  with
  1012.            scanners  that  return   different  errorlevels  for  different
  1013.            situations i.e. no memory, no files to scan, etc.
  1014.  
  1015.            ╒══════════════════════════════════════════════════════════════╕
  1016.            │░░░░░░ FILES.RA ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  1017.            ╘══════════════════════════════════════════════════════════════╛
  1018.  
  1019.            Labtest obtains  much of the needed  information concerning your
  1020.            file system directly from your FILES.RA. Each item is identified
  1021.            and described below:
  1022.  
  1023.            File area path: Labtest uses  this information when moving files
  1024.            and  updating your  database. You  should have  a complete path,
  1025.            including drive, defined in each of your file areas.
  1026.  
  1027.            Default  archive  type:  This  field  is  optional,  and  if not
  1028.            specified, is  overridden by the  Default Arc type  specified in
  1029.            your Labtest configuration file. Archives destined for this file
  1030.            area will be converted to this archive type.
  1031.  
  1032.            Long  desc: You  must enable  long descriptions  for all of your
  1033.            file areas. This does not  actually affect Labtest, however, the
  1034.            descriptions  imported  from  FILE_ID.DIZ   files  will  not  be
  1035.            displayed by RemoteAccess unless this is set to Yes.
  1036.  
  1037.            ╒══════════════════════════════════════════════════════════════╕
  1038.            │░░░░░░ MESSAGES.RA ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  1039.            ╘══════════════════════════════════════════════════════════════╛
  1040.  
  1041.            Like  FILES.RA,  Labtest  obtains  information  concerning  your
  1042.            message areas from MESSAGES.RA.
  1043.  
  1044.            Labtest determines the message board  type (JAM or HUDSON) based
  1045.            on that  found in the message  area pointed to by  the Sysop and
  1046.            User message boards defined  in your Labtest configuration file.
  1047.            Additionally, Labtest  will determine the JAM  message base path
  1048.            if the message area is a JAM base.
  1049.  
  1050.            ╒══════════════════════════════════════════════════════════════╕
  1051.            │░░░░░░ CONFIG.RA ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  1052.            ╘══════════════════════════════════════════════════════════════╛
  1053.  
  1054.            As  with FILES.RA  and MESSAGES.RA,  other important information
  1055.            about your BBS is read from CONFIG.RA:
  1056.  
  1057.            Multiline:  The Setup  program determines  if your  system is  a
  1058.            multiline  system  based  on  the  setting  found under System -
  1059.            Multiline. This  controls the log  file writing and  some safety
  1060.            checks provided by Labtest to  keep each node from clashing with
  1061.            another.
  1062.  
  1063.            Message base  path: The base  directory for your  Hudson message
  1064.            base.  Jam   message  base  paths   are  determined  from   your
  1065.            MESSAGES.RA file.
  1066.  
  1067.            File base path: The base directory for your file databases.
  1068.  
  1069.                                          12
  1070.  
  1071.  
  1072.  
  1073.  
  1074.            Sysop name: Your Sysop name of course!
  1075.  
  1076.            System name: The name of your BBS.
  1077.  
  1078.            Be sure to setup your Upload Scan portion of CONFIG.RA:
  1079.  
  1080.            Below  is  a  screen  snapshot  of  the  Upload  Scanner menu of
  1081.            RACONFIG to  show you how to  setup Labtest in your  Upload Scan
  1082.            utility command  line. Labtest will mark  the files as indicated
  1083.            in the  Failed Scan Action  section of Setup.  Additionally, you
  1084.            may specify  a file area in  Setup to move failed  files to, and
  1085.            Labtest will move the files to that area.
  1086.  
  1087.            ╒══════════════════════════════════════════════ Upload Scanner ┐
  1088.            │                                                              │
  1089.            │ Scan online  Yes                                             │
  1090.            │ Failed scan  /unavailable                                    │
  1091.            │ Scan utility C:\RA\LABTEST.EXE @ /O *! *M                    │
  1092.            │                                                              │
  1093.            ╘═════════════════════════════════════════════════════════════─┘
  1094.  
  1095.            ╒══════════════════════════════════════════════════════════════╕
  1096.            │░░░░░░ RUNNING LABTEST ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  1097.            ╘══════════════════════════════════════════════════════════════╛
  1098.  
  1099.            Labtest  may be  run from  RemoteAccess while  a user is online,
  1100.            from the RAMGR program as a function key or from the Dos command
  1101.            line. There  are several command line  options which temporarily
  1102.            modify Labtest's  operation, overriding the  configuration file.
  1103.            These command line options, or switches, are described below:
  1104.  
  1105.            /L Causes Labtest to run in 'local' mode. In Local Mode, Labtest
  1106.               will not attempt to read a  door information file nor will it
  1107.               post messages to the sysop or the user.
  1108.  
  1109.            /O This  is the Override command.  Labtest will normally process
  1110.               only  those  files  not   previously  proceseed.  Using  this
  1111.               command, you will force Labtest to ignore it's own time stamp
  1112.               feature. This  is highly recommended while  running under the
  1113.               BBS system.  An industrious person may  determine the special
  1114.               file stamping and attempt to  trick Labtest. This will ensure
  1115.               that this will never happen.
  1116.  
  1117. >          /E This switch forces Labtest to look in the specified directory
  1118. >             for the EXITINFO.BBS file.  Example: /EC:\RA\NODE1. Note that
  1119.               this is only  a path, not a full  filename! Proper format for
  1120.               this  switch  is  /EC:\RA\NODE*N  (specify  whatever path you
  1121.               like, use of the *N is optional)
  1122.  
  1123.            /N Specifies the node number which Labtest is operating on. This
  1124.               is extremely important to keep  one user's files from getting
  1125.               mixed  up with  another user's  files. The  proper format for
  1126.               this switch is /N*N on the Labtest command line in RACONFIG.
  1127.  
  1128.            /NOSCAN or /NS: When this command is given, Labtest will not run
  1129.                            the virus scanner on any file during the current
  1130.                            session. Note this is  only useful when you just
  1131.                            want  to  convert  your  files  to  one  format.
  1132.                            Otherwise, this is not recommended.
  1133.  
  1134.            /NOREARC or /NR: Prevents Labtest from rearchiving files.
  1135.  
  1136.                                          13
  1137.  
  1138.  
  1139.  
  1140.            /NOCOMMENT  or  /NC:  Prevents  Labtest  from  adding an archive
  1141.                                  comment.
  1142.  
  1143.            In addition, you must tell  Labtest what file, directory or file
  1144.            area you want processed. You may specify more than one file name
  1145.            or  directory, or  any combination  of the  above. Wildcards are
  1146.            valid. A few examples are listed below:
  1147.  
  1148.            If you run Labtest with no command line parameters, Labtest will
  1149.            load and run LTSETUP.EXE.
  1150.  
  1151.            To run Labtest on your file  area # 15 in local mode, processing
  1152.            only new files:
  1153.  
  1154.            LABTEST 15 /L
  1155.  
  1156.            This will cause  Labtest to process ALL files  in the C:\UPLOADS
  1157.            directory:
  1158.  
  1159.            LABTEST C:\UPLOADS\*.* /L /O
  1160.  
  1161.            This will  run Labtest on  the specified archive,  in local mode
  1162.            with debugging on:
  1163.  
  1164.            LABTEST C:\UPLOAD\LABTST30.ARJ /L /O
  1165.  
  1166.            To run Labtest from RemoteAccess, you must specify the following
  1167.            commandline in RACONFIG - FILES - UPLOAD SCAN:
  1168.  
  1169.            C:\RA\LABTEST\LABTEST.EXE @ /O *M
  1170.  
  1171.            (The  actual  drive/path  names  will  vary  depending  on  your
  1172.            installation)
  1173.  
  1174.            The @  symbol is a RemoteAccess  macro which is replaced  by  the
  1175.            full path and filename of the uploaded file. The /O switch ensures
  1176.            nothing is skipped by Labtest.
  1177.  
  1178.            The *M  causes RemoteAccess to  swap out of  memory, making room
  1179.            for Labtest.
  1180.  
  1181.            To  run  Labtest  from  the  RAMGR  program,  you  must define a
  1182.            function  key in  RACONFIG -  FILES  -  RAMGR FN  KEYS. Use  the
  1183.            following command line:
  1184.  
  1185.            C:\RA\LABTEST\LABTEST.EXE @ /O /L *M
  1186.  
  1187.            Please  note that  Labtest will  search the  FILES.RA file for a
  1188.            path matching  the path specified  on the command  line. Labtest
  1189.            will expand  wildcards to a path  and wildcard. If there  was no
  1190.            matching  path found  in the  FILES.RA file,  no updates will be
  1191.            made to the file database. Labtest will add the file information
  1192.            to the database  if it does not already  exist. Additionally, if
  1193.            the file being processed fails  any portion of Labtest, the file
  1194.            will  be marked  and/or moved  according to  the setting  in the
  1195.            LABTEST.CFG.  This is  particularly useful  when handling  files
  1196.            offline or when using an upload door program.
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.                                          14
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.            ╒══════════════════════════════════════════════════════════════╕
  1209.            │░░░░░░ RUNNING UNDER OS/2 AND DESQVIEW ░░░░░░░░░░░░░░░░░░░░░░░│
  1210.            ╘══════════════════════════════════════════════════════════════╛
  1211.  
  1212.            Labtest has been tested on  systems using OS/2 2.1x and Desqview
  1213.            2.6.  Important   things  to  note  when   running  under  these
  1214.            environments is  to set aside  enough memory for  Labtest and the
  1215.            external programs it uses. Normally, this would be about 450k or
  1216.            more. All of Labtest's screen output is compatible with Desqview
  1217.            and  OS/2. You  should ensure  you have  an ANSI  driver such as
  1218.            ANSI.COM (supplied  with your distribution  archive) in each  of
  1219.            the Desqview windows you are using Labtest in.
  1220.  
  1221.            ╒══════════════════════════════════════════════════════════════╕
  1222.            │░░░░░░ CUSTOMIZATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  1223.            ╘══════════════════════════════════════════════════════════════╛
  1224.  
  1225.            Labtest's  output (remote  and local)  is fully  customizable by
  1226.            using  the  LABTEST.CTL  and  various  screen  drawing programs.
  1227.            Please refer to the file LABTEST.CTL in the distribution archive
  1228.            for  detailed information  on how  to modify  and customize your
  1229.            copy of Labtest.  In general, all that is  required is to modify
  1230.            the supplied  .ASC/.ANS/.RIP screens with  an appropriate screen
  1231.            editor.  While editing,  special note  should be  made as to the
  1232.            location of  various text prompts  on the screen.  Then, editing
  1233.            the   LABTEST.CTL  file,   change  the   corresponding  prompts/
  1234.            locations. For .ANS screens,  this process is relatively simple.
  1235.            However, for .RIP screens, this process becomes very complex and
  1236.            is  not recommended.
  1237.  
  1238.            Included with the distribution  archive is a sample LABTEST.RIP,
  1239.            LABTEST.ANS, LABTEST.ASC and  the accompanying LABTEST.CTL file.
  1240.            You may  use these stock screens  without modification. But most
  1241.            sysops  like  to  give  their  BBS  a  personal  touch.  Indepth
  1242.            information on how to tell Labtest  where to display text on the
  1243.            screen is contained in the control file LABTEST.CTL. You can use
  1244.            a drawing program like THEDRAW to change the .ANS screen. During
  1245.            the processing  Labtest will use the  screen region beginning at
  1246.            line 17 and  ending at line 23. This will  not effect the user's
  1247.            screen,  only the  sysop screen.  If you  have the Remote Status
  1248.            Window set  to Yes in LTSETUP,  Labtest will use this  region on
  1249.            the user's screen as well. Please  do us the courtesy of leaving
  1250.            our copyright information in your  custom screens as this is the
  1251.            only advertisement we have.
  1252.  
  1253. >          If the  user's terminal is set  for ASCII output only,  the file
  1254. >          named  in LTSETUP  -> Ascii  Screen will  be sent  to the remote
  1255. >          terminal, while the  Ansi Screen is sent to  the local terminal.
  1256. >          The user will see the progress of the file as plain text prompts
  1257. >          exactly as you will see them in the Status Window. These are the
  1258. >          same text prompts used in writing to your log file.
  1259.  
  1260.            You  may name  the screens  and control  file anything you wish,
  1261.            just be sure to put the correct name and path in the LABTEST.CFG
  1262.            file. On multi-line systems, it  is possible to have a different
  1263.            screen setup for each node,  just create each screen and control
  1264.            file, and specify them in the appropriate LABTEST.Cxx files.
  1265.  
  1266.  
  1267.  
  1268.  
  1269.                                       15
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.            About using RIP with Labtest
  1276.  
  1277.            Labtest will determine the user's RIP graphics capabilities from
  1278.            the EXITINFO.BBS  file. If the  user has a  RIP-capable terminal
  1279.            program, then the RIP screen specified in your .CFG file will be
  1280.            displayed.  Simultaneously, Labtest  will display  the .ANS file
  1281.            specified in your  .CFG file. The Sysop will  hardly notice that
  1282.            the user is using RIP  graphics. To make it somewhat discernable
  1283.            from  an .ANS  caller, the  local screen  will not have blinking
  1284.            colors. This lets you know that the user is in RIP mode.
  1285.  
  1286.            Due to the complexity of modifying the .RIP file and matching up
  1287.            the locations  of the text  prompts, it is  not recommended that
  1288.            you  attempt to  change the  .RIP screen.  Instead just  use the
  1289.            supplied .RIP screen and you'll do just fine!
  1290.  
  1291.            ╒══════════════════════════════════════════════════════════════╕
  1292.            │░░░░░░ SUPPORT FILES ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  1293.            ╘══════════════════════════════════════════════════════════════╛
  1294.  
  1295.            The following  is a list  of files related  to the operation  of
  1296.            this program. It is noted whether  or not the file is absolutely
  1297.            required in order for the program to run.
  1298.  
  1299.            Filename        Required  Description
  1300.            ------------    --------  --------------------------------------
  1301.            LABTEST.EXE       Yes     The main executable.
  1302.            LTSETUP.EXE       Yes     Configuration program.
  1303.            LABTEST.LNG       Yes     Help prompts for LTSETUP.EXE
  1304.            DOSWIN.EXE        Yes     Required for Dos Window display box.
  1305.            NODOSWIN.EXE      Yes     Required for the Invisible Dos Window.
  1306.            PAGE.EXE          No      Plays the page tune file from dos.
  1307.            DEC2RIP.EXE       No      Converts Decimal - Rip numbers
  1308.            LABTEST.CFG       Yes     Configuration file - ascii text file
  1309.            LABTEST.RIP       Yes     Screen displayed to RIP callers
  1310.            LABTEST.ANS       Yes     Screen displayed to ANSI callers
  1311.            LABTEST.ASC       Yes     Screen displayed to Ascii callers
  1312.            LABTEST.CTL       Yes     Control file for output screen
  1313.            ORDER.FRM         No      The program registration form.
  1314.            LABTEST.DOC       No      The User's Manual
  1315.            *.MSG             No      Message text files to be written to
  1316.                                      the user
  1317.            DJPEG.EXE         No      Required for decompressing .JPG files
  1318.            CJPEG.EXE         No      Required for compressing .GIF files
  1319.            ANSI.COM          No      Needed  for  Desqview  users  (other
  1320.                                      Desqview  Ansi   device  drivers  will
  1321.                                      work,  this is  provided if  you don't
  1322.                                      have one.)
  1323.            PAGE.LAB          No      Example page files that you can use
  1324.                                      as a virus alarm.
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.                                       16
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.            ╒══════════════════════════════════════════════════════════════╕
  1344.            │░░░░░░ EXTERNAL PROGRAM ERRORLEVELS ░░░░░░░░░░░░░░░░░░░░░░░░░░│
  1345.            ╘══════════════════════════════════════════════════════════════╛
  1346.  
  1347. >          LABTEST ERROR CODES
  1348. >
  1349. >          Labtest will exit with an error code indicating the success or
  1350. >          failure of the file processed. The error codes are listed below:
  1351. >
  1352. >          0         :Success, no problems detected.
  1353. >          1         :A virus was detected.
  1354. >          2         :Archive file could not be processed. Possibly a bad
  1355. >                     archive.
  1356. >          4         :Gif file did not satisfy resolution requirements.
  1357. >          8         :The archive file date was beyond the maximum age limit.
  1358. >                     or maximum old file limit was exceeded.
  1359. >          16        :One or more imbedded files could not be processed.
  1360. >          32        :One or more files were listed in your Hack report.
  1361. >          64        :One or more files were found in your unwanted list.
  1362. >
  1363. >          If more than one error occurred, Labtest will add the errorcodes
  1364. >          and report the sum.  Thus, if a file was old and failed the
  1365. >          virus scan, Labtest will report an errorlevel of 9.
  1366.  
  1367.            Errorlevels  for  external  programs  will  be  recorded in your
  1368.            LABTEST.LOG file.  If a problem  arises, review the  log file to
  1369.            determine the errorcode and possible source of the problem.
  1370.  
  1371.            The  following  information  has  been  extracted  from  various
  1372.            utility program documentation files to provide you with a single
  1373.            source for error level definitions:
  1374.  
  1375.            PKZIP ERROR CODES
  1376.  
  1377.            1         :Bad file name of file specification
  1378.            2-3       :Error in ZIP file
  1379.            4-11      :Insufficient memory
  1380.            12        :No files were found to add to the ZIP file or
  1381.                       no files were specified for deletion.
  1382.            13        :File  not found. The  specified ZIP file  or list file
  1383.                       was not found.
  1384.            14        :Disk  full
  1385.            15        :Zip file is read-only and can not be modified.
  1386.            16        :Bad or illegal parameters specified.
  1387.            17        :Too many files.
  1388.  
  1389.            PKUNZIP ERROR CODES
  1390.  
  1391.            1         :Warning error (such as failed CRC check)
  1392.            2-3       :Error in ZIP file
  1393.            4-8       :Insufficient memory
  1394.            9         :File not found. No zip files found.
  1395.            10        :Bad or illegal parameters specified.
  1396.            11        :No files found to extract/view etc.
  1397.            50        :Disk full
  1398.            51        :Unexpected end of file in ZIP file.
  1399.  
  1400.            ARJ ERROR CODES
  1401.  
  1402.            1         :Warning Specified file to add not found
  1403.  
  1404.                                       17
  1405.  
  1406.  
  1407.  
  1408.  
  1409.                       Specified file to list, extract, etc., not found
  1410.                       or answering negatively to "OK TO PROCEED TO NEXT
  1411.                       VOLUME" prompt
  1412.            2         :Fatal error
  1413.            3         :CRC error
  1414.            4         :ARJ-SECURITY error or attempt to update an ARJ-SECURED
  1415.                       archive.
  1416.            5         :Disk full or write error
  1417.            6         :Can't open archive or file
  1418.            7         :Simple user error (bad parameters)
  1419.            8         :Not enough memory
  1420.  
  1421.            LHARC ERROR CODES
  1422.  
  1423.            1         :CRC error
  1424.            2         :Fatal error.
  1425.            3         :Failed to write tempory files in the archive.
  1426.  
  1427.            PKUNPAK ERROR CODES
  1428.  
  1429.            1         :Bad CRC warning
  1430.            2         :Out of memory
  1431.            3         :No archives found to extract
  1432.            4         :Can't open archive file
  1433.            5         :Read error on archive
  1434.            6         :Internal table overflow
  1435.            7         :Disk Full
  1436.  
  1437.            PAK ERROR CODES
  1438.  
  1439.            1         :CRC error
  1440.            2         :Out of memory
  1441.            7         :Disk Full
  1442.  
  1443.            McAffee's VIRUSCAN Version 9.20V109 EXIT CODES
  1444.  
  1445.            0         :No viruses found
  1446.            1         :One or more viruses found
  1447.            2         :Abnormal termination (program error)
  1448.            3         :One or more uncertified files found
  1449.            4         :Ctrl-C or Ctrl-Break aborted scan
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.                                          18
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.            ╒══════════════════════════════════════════════════════════════╕
  1477.            │░░░░░░ CONTACTING THE AUTHOR ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  1478.            ╘══════════════════════════════════════════════════════════════╛
  1479.  
  1480.            The author may be contacted by writing to:
  1481.  
  1482. >          Mark Williamson
  1483. >          PO Box 1233
  1484. >          Lemoore, CA 93245
  1485.  
  1486.            Or by sending Netmail to 1:214/53.
  1487.  
  1488.            (The above is subject to change in July 1994, as I am moving to
  1489.            San Diego, California.)
  1490.  
  1491.            Alternatively, you may log onto the support BBS at (209)998-7249
  1492.            and leave a comment to the sysop.
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.                                          19
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.