Beijing Paradise BBS Backup

home *** CD-ROM | disk | FTP | other *** search

/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / LABTST32.ZIP / LABTEST.DOC < prev next >

Wrap

Text File | 1994-10-15 | 106.0 KB | 2,577 lines

Labtest 3.2 User's Guide Copyright (c) 1992-1994 Mark Williamson Labtest 3.2 User's Guide Note: It is important that you read this documentation in depth. Most common problems are caused by an incorrect setup. 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 1 What is Labtest and What Does It Do? . . . . . . . . . . . . 1 Thanks for Trying Labtest! . . . . . . . . . . . . . . . . . 3 Labtest Copyright Information . . . . . . . . . . . . . . . 3 License Agreement . . . . . . . . . . . . . . . . . . . . . 3 The Beta Team . . . . . . . . . . . . . . . . . . . . . . . 5 Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 6 2 System Requirements . . . . . . . . . . . . . . . . . . . . . . 7 Hardware Requirements . . . . . . . . . . . . . . . . . . . 7 Communications Output . . . . . . . . . . . . . . . . . . . 7 Memory Swapping . . . . . . . . . . . . . . . . . . . . . . 7 External programs . . . . . . . . . . . . . . . . . . . . . 8 3 Installation . . . . . . . . . . . . . . . . . . . . . . . . . 8 4 Menu Navigation . . . . . . . . . . . . . . . . . . . . . . . . 10 5 Configuration Options . . . . . . . . . . . . . . . . . . . . . 11 Files/Paths . . . . . . . . . . . . . . . . . . . . . . . . 11 Log File Path . . . . . . . . . . . . . . . . . . . . . 11 Swap Path . . . . . . . . . . . . . . . . . . . . . . . 11 Bad File Path . . . . . . . . . . . . . . . . . . . . . 11 ANSI Screen File . . . . . . . . . . . . . . . . . . . 12 ASCII Screen File . . . . . . . . . . . . . . . . . . . 12 RIP Screen File . . . . . . . . . . . . . . . . . . . . 12 Screen Control File . . . . . . . . . . . . . . . . . . 12 Kill File List . . . . . . . . . . . . . . . . . . . . 13 Add File List . . . . . . . . . . . . . . . . . . . . . 13 Page File Name . . . . . . . . . . . . . . . . . . . . 13 Hack File Name . . . . . . . . . . . . . . . . . . . . 13 Archive Comment File Name . . . . . . . . . . . . . . . 14 Inbound TIC Directory . . . . . . . . . . . . . . . . . 14 Duplicate File Database . . . . . . . . . . . . . . . . 14 Anti-BBS Ad Text File . . . . . . . . . . . . . . . . . 15 Editor Command . . . . . . . . . . . . . . . . . . . . 15 BBS Interface . . . . . . . . . . . . . . . . . . . . . . . 15 Sysop Message Board . . . . . . . . . . . . . . . . . . 16 i Labtest 3.2 User's Guide User Message Board . . . . . . . . . . . . . . . . . . 16 Set Security Level . . . . . . . . . . . . . . . . . . 16 Add Uploader Name . . . . . . . . . . . . . . . . . . . 16 Remote Status Window . . . . . . . . . . . . . . . . . 17 BBS System . . . . . . . . . . . . . . . . . . . . . . 17 Description Offset Value . . . . . . . . . . . . . . . 17 Description Continuation Character . . . . . . . . . . 18 User Message Setup . . . . . . . . . . . . . . . . . . 18 All Ok Message . . . . . . . . . . . . . . . . . . 19 Virus Message . . . . . . . . . . . . . . . . . . 19 Bad Gif Message . . . . . . . . . . . . . . . . . 19 Bad File Message . . . . . . . . . . . . . . . . . 19 Old File Message . . . . . . . . . . . . . . . . . 19 Hack Report Message . . . . . . . . . . . . . . . 20 Dupe File Message . . . . . . . . . . . . . . . . 20 Sysop Messages . . . . . . . . . . . . . . . . . . . . 20 File Comments . . . . . . . . . . . . . . . . . . . . . 20 Control Menu . . . . . . . . . . . . . . . . . . . . . . . . 21 Sysop Name . . . . . . . . . . . . . . . . . . . . . . 21 Registration Key . . . . . . . . . . . . . . . . . . . 21 Max File Age . . . . . . . . . . . . . . . . . . . . . 21 Sound Virus Alarm . . . . . . . . . . . . . . . . . . . 21 Swapping method . . . . . . . . . . . . . . . . . . . . 21 DOS Window Height . . . . . . . . . . . . . . . . . . . 22 GIF Options . . . . . . . . . . . . . . . . . . . . . . . . 22 Check GIF Age . . . . . . . . . . . . . . . . . . . . . 22 Minimum GIF Width . . . . . . . . . . . . . . . . . . . 23 Minimum GIF Height . . . . . . . . . . . . . . . . . . 23 Minimum GIF Colors . . . . . . . . . . . . . . . . . . 23 GIF Separator Character . . . . . . . . . . . . . . . . 23 Compress GIF Files . . . . . . . . . . . . . . . . . . 23 Uncompress JPG Files . . . . . . . . . . . . . . . . . 23 Archive File Menu . . . . . . . . . . . . . . . . . . . . . 24 Default Archive Type . . . . . . . . . . . . . . . . . 24 Maximum Old File Percentage . . . . . . . . . . . . . . 24 File Date Options . . . . . . . . . . . . . . . . . . . 24 Newest File . . . . . . . . . . . . . . . . . . . 24 Oldest File . . . . . . . . . . . . . . . . . . . 24 Keep Date . . . . . . . . . . . . . . . . . . . . 24 System Date . . . . . . . . . . . . . . . . . . . 24 Convert SFX Files . . . . . . . . . . . . . . . . . . . 25 Pack Unknown Files . . . . . . . . . . . . . . . . . . 25 ii Labtest 3.2 User's Guide Keep Security . . . . . . . . . . . . . . . . . . . . . 25 Imbedded Archives . . . . . . . . . . . . . . . . . . . 25 Ignore . . . . . . . . . . . . . . . . . . . . . . 25 Scan . . . . . . . . . . . . . . . . . . . . . . . 25 Rearc . . . . . . . . . . . . . . . . . . . . . . 25 Scan/Rearc . . . . . . . . . . . . . . . . . . . . 25 Process Descriptions . . . . . . . . . . . . . . . . . 26 Maximum File Size . . . . . . . . . . . . . . . . . . . 26 Maximum Duplicate Files . . . . . . . . . . . . . . . . 26 Maximum Duplicate File Percent . . . . . . . . . . . . 26 Maximum Advertisement File Size . . . . . . . . . . . . 26 Delete BBS Advertisements . . . . . . . . . . . . . . . 27 Adjust User Credit . . . . . . . . . . . . . . . . . . 27 Failed Scan Action . . . . . . . . . . . . . . . . . . 27 None . . . . . . . . . . . . . . . . . . . . . . . 27 Unlisted . . . . . . . . . . . . . . . . . . . . . 27 Not Available . . . . . . . . . . . . . . . . . . 27 Mark Deleted . . . . . . . . . . . . . . . . . . . 27 Move . . . . . . . . . . . . . . . . . . . . . . . 27 Move/Unlisted . . . . . . . . . . . . . . . . . . 27 Archiver Setup . . . . . . . . . . . . . . . . . . . . . . . 28 Archive Extension . . . . . . . . . . . . . . . . . . . 28 Unpack Command Line . . . . . . . . . . . . . . . . . 28 Pack Command Line . . . . . . . . . . . . . . . . . . . 29 Comment Command Line . . . . . . . . . . . . . . . . . 29 Video . . . . . . . . . . . . . . . . . . . . . . . . . 30 Full Screen . . . . . . . . . . . . . . . . . . . 30 DOS Window . . . . . . . . . . . . . . . . . . . . 30 Disable Video . . . . . . . . . . . . . . . . . . 31 Virus Scanner Setup . . . . . . . . . . . . . . . . . . . . 31 Scan Command Line . . . . . . . . . . . . . . . . . . . 31 Errorlevel . . . . . . . . . . . . . . . . . . . . . . 32 Video . . . . . . . . . . . . . . . . . . . . . . . . . 32 Enable . . . . . . . . . . . . . . . . . . . . . . . . 32 Scan Log Text . . . . . . . . . . . . . . . . . . . . . 32 6 Using LTSetup to Process Your Files . . . . . . . . . . . . . . 33 Select Files . . . . . . . . . . . . . . . . . . . . . . . . 33 Select File Areas . . . . . . . . . . . . . . . . . . . . . 34 CD-ROM Support . . . . . . . . . . . . . . . . . . . . . . . 34 Convert . . . . . . . . . . . . . . . . . . . . . . . . . . 34 Scan . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 iii Labtest 3.2 User's Guide Override . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Process .TIC Files . . . . . . . . . . . . . . . . . . . . . 35 Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 7 Printing/Exporting Your Configuration File . . . . . . . . . . 35 8 Customizing Labtest's Displays . . . . . . . . . . . . . . . . 35 9 Running Labtest . . . . . . . . . . . . . . . . . . . . . . . . 36 /L Local Mode . . . . . . . . . . . . . . . . . . . . . . . 36 /O Override Mode . . . . . . . . . . . . . . . . . . . . . . 36 /E EXITINFO Path . . . . . . . . . . . . . . . . . . . . . . 36 /N Node Number . . . . . . . . . . . . . . . . . . . . . . . 37 /NS No Scan . . . . . . . . . . . . . . . . . . . . . . . . 37 /NR No Conversion . . . . . . . . . . . . . . . . . . . . . 37 /NC No Comments . . . . . . . . . . . . . . . . . . . . . . 37 /ND No Delete . . . . . . . . . . . . . . . . . . . . . . . 37 /- No uploader name . . . . . . . . . . . . . . . . . . . . 38 10 External Program Errorlevels . . . . . . . . . . . . . . . . . 39 PkZip 2.04g . . . . . . . . . . . . . . . . . . . . . . . . 39 PkUnzip . . . . . . . . . . . . . . . . . . . . . . . . . . 39 ARJ . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 LHARC . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 PKUNPAK . . . . . . . . . . . . . . . . . . . . . . . . . . 40 PAK . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 McAffee's VIRUSCAN Version 9.20V109 EXIT CODES . . . . . . . 40 11 Registration, warranty and licensing . . . . . . . . . . . . . 41 12 Customer Support Policy . . . . . . . . . . . . . . . . . . . 42 North American Support Sites . . . . . . . . . . . . . . . . 42 13 Registration . . . . . . . . . . . . . . . . . . . . . . . . . 43 Labtest Registration Form . . . . . . . . . . . . . . . . . 44 14 Contacting the author . . . . . . . . . . . . . . . . . . . . 45 iv Labtest 3.2 User's Guide 1 Introduction What is Labtest and What Does It Do? Labtest is a program designed to process files received by a computer Bulletin Board System (BBS). However, Labtest is not just for the operators of BBS's. If you use your modem to download files from BBS's, you can use Labtest to maintain your files and a list containing descriptions about each file. Some of Labtest's many features are: Completely customizable! All display, message and language files can be modified to suite your tastes. Support for the Hack List - searches the HACK.IDX/HACK.COL and fails the file if it exists in the list, logging the reason to the log file. Can be configured to skip certain files, ensuring that files you want untouched are never processed. Adjust a user's security level if they upload a file which contains a virus. Appends the file description with information about the status (pass/fail) and the reason for fairure. Will also add the file count, oldest and newest dates to the description as well as the uploader's name. Honors archive security (configurable) Automatically detects archive formats using the archive signature. Convert from any supported archive format to any other. Execute up to 20 virus scanners for the most thorough protection possible. All virus scanners are user definable. Can capture multiple errorlevels from a single pass (very useful for Thunderbyte) Can be configured to record the virus scanner log 1 Labtest 3.2 User's Guide information and write it to the log file, user message and/or sysop message. Duplicate file protection. Checks the files inside archivesagainst your duplicate file database. You may define a maximum duplicate percentage or count, or both. Checks all files in the archive, even in subdirectories to any level. Detect and optionally remove unwanted bulletin board advertisements based on a text string search and/or filename comparison. Process inbound .TIC files, automatically add the files to the file system and process them according to the defined settings. No downlink options (yet!) Writes one or more detailed messages to the user and Sysop pertaining the uploaded file. Each message can be enabled or disabled. The message text is fully customizable, including several macros for system information. Reads .GIF files for resolution information and imports this info into the file data base. Can fail GIFs that are less than a defined resolution. Convert GIF files to JPG format as well. Thorough online help to guide you through the configuration phase. May be configured to fail archived files based on age, including percentage of old files. Again, supporting imedded archives and subdirectories to any level. Integrates seemlessly with any RemoteAccess 2.xx, ProBoard 2.xx, or QuickBBS 2.80 (Classic/GoldBase) bulletin board system or any system using FILES.BBS. Even if you do not use a BBS, you can still use Labtest to process files you may download from other bulletin board systems. Supports five message base formats: JAM, Hudson, GoldBase, *.MSG and Squish. 2 Labtest 3.2 User's Guide Supports extended FILES.BBS formatting used by ProBoard 2.xx. Supports lengthy FILES.BBS descriptions by indenting to a specified column and optionally add a lead character, for example the '|' before each continuation line. Professionally printed user's manual will soon be available. Thanks for Trying Labtest! Labtest 3.2 is the latest version of an excellent archived file processor. It is an easily-configured, very powerful method of automatically testing all files received on a BBS system, whether they are recieved from callers as an upload, or via standard file distribution channels. Labtest Copyright Information Labtest, including the online information and text documentation, is the copyrighted creation of Mark Williamson, Copyright (c) 1992 - 1994. It has been thoroughly tested on many different system configurations and has been found to work as described in this manual. It is not guaranteed, however, to function perfectly on your system. If you discover a problem, the author will work with you to determine the cause of the problem and the best solution. License Agreement This is a licence agreement between you, the end user, and Mark Williamson, hereafter "the author". The Labtest 3.2 softwareand information attached hereto, hereafter "LABTEST", is theproperty of the author. Read the terms and conditions of this licence agreement carefully before using the software. If you for any reason, whatsoever, cannot accept the conditions in this agreement, you are not permitted to use LABTEST. You acknowledge and agree that LABTEST is a proprietary product of the author, protected by applicable copyright laws and international treaty provisions. You further acknowledge and agree that all rights, title, and interest in and to LABTEST are 3 Labtest 3.2 User's Guide and shall remain with the author. LABTEST may be used for a period of thirty (30) days on a trial basis to allow you to determine its suitability for your particular application. After this period you MUST register each copy of LABTEST that you run simultaneously. Registration entitles you to a non-transferable licence to use LABTEST and any future versions of LABTEST for as long as you wish, subject to any special licensing conditions and/or applicable upgrade fees attached to future versions. Any given version of LABTEST is considered obsolete if the file date of the executable file LABTEST.EXE is more than six months old. Due to continuous development, the author will not provide support on obsolete versions of LABTEST. Users are encouraged to contact the author for information regarding the latest version and any planned future releases. In the event that you are in violation of this licence agreement, you agree and accept that the author may cancel your registration and any rights to use LABTEST that you may have. In the case of a dispute over the licence agreement, you further agree and accept to fully reimburse the author for legal and other expenses resulting from the dispute, should the dispute be decided in favor of the author. LABTEST is provided "as is", without warranty of any kind or fitness for a particular purpose, either expressed or implied, all of which are hereby explicitly disclaimed. The author only guarantees that Labtest will occupy disk space. The author's liability resulting from your use or inability to use LABTEST is limited to the amount that the affected party has paid for it, or in the event that LABTEST was registered with a third party for payment to the author, liability is limited to the amount that was received by the author from that third party. Neither the author nor any of his employees, agents, or other representatives are in any way obligated to provide future versions of, or support for, LABTEST. You may freely distribute and copy LABTEST provided that no fee 4 Labtest 3.2 User's Guide is charged and the LABTEST distribution archive contains unmodified copies of the original files as produced by the author. Pay Bulletin Board Systems may, however, charge their normal fee provided that no additional charge for LABTEST is levied. No part of LABTEST may be modified, altered, reverse engineered, sold, or distributed in any form whatsoever which would involve some sort of trade without prior written permission from the author. The Beta Team Labtest and the accompanying files are a collective work of the efforts of many people, without whose involvement this project would not have been possible. I wish to express my sincere gratitude to the following people: Scott Livingston 1:142/212@fidonet.org Phone Henge BBS BBS: (203) 673-6247 New Britain, CT Eddy Salvador 1:107/957@fidonet.org Integrated Circuits BBS BBS: (908) 354-4395 Elizabeth, NJ Miguel Salvador 1:107/957@fidonet.org Integrated Circuits BBS BBS: (908) 354-4395 Elizabeth, NJ Mark McNew 1:19/14@fidonet.org Sirius BBS: (501) 424-2510 Mountain Home, AR Glen Appleton 1:260/371@fidonet.org Psycho Ward BBS BBS: (315) 478-2042 Syracuse, NY Gary L. Murphy 1:130/85@fidonet.org The Recovery Corner II BBS: (817) 447-3580 Burleson, TX Hector Cintron 1:142/1778@fidonet.org U.S.S. Nautilus BBS: (203) 827-0280 5 Labtest 3.2 User's Guide New Britain, CT William Brooks 1:264/415@fidonet.org Gameworld BBS BBS: (804) 261-0687 Glen Allen, VA Gary Petersen 1:280/389@fidonet.org Midwest Xpress BBS: (913) 894-8835 Lenexa, KS Marlin England 1:309/45@fidonet.org All Around the World BBS BBS: (602) 458-6371 Fort Huachuca, AZ Mike Poston 1:280/32@fidonet.org The Sounding Board BBS BBS: (816) 361-9294 Kansas City, MO Scott Drake 1:107/922@fidonet.org The T.E.R.N. BBS BBS: (201)399-4772 Irvington, NJ The beta team has been an immense help in bringing Labtest 3.2 to you. I appreciate their help enormously! Thanks everyone! A large amount of Labtest's functionality is attributable to the efforts of many people. My genuine thanks go to everyone who, at one time or another, helped improve Labtest. Acknowledgements Due to its complexity, Labtest uses code and information provided from numerous sources. Here are the required notations: The Graphics Interchange Format (c) is the Copyright property of CompuServe Incorporated. GIF (sm) is a Service Mark property of CompuServe Incorporated. This product uses the JAM (mbp) API - Copyright (c) 1993 - 1994, Joaquim Homrighausen, Andrew Milner, Mats Birch, Mats Wallin. ALL RIGHTS RESERVED. 6 Labtest 3.2 User's Guide This product uses the RIPscrip language, Copyright (c) 1993 - 1994, Telegrafix Communications, Inc. RemoteAccess, RACONFIG, RAMGR, and RA are Copyright (c) 1993 - 1994, Andrew Milner. ProBoard and PROCFG are Copyright (c) 1993-1994, Philippe Leybaert. QuickBBS and GoldBase are Copyright (c) 1994, Steve Gabrilowitz. This product uses the OpenDoors library, Copyright (c) 1994, Brian Pirie. 2 System Requirements Hardware Requirements Labtest requires an IBM(TM) compatible computer system with at least 512k of memory, one megabyte of free drive space and a VGA monitor is recommended. Labtest has been tested on numerous platforms ranging from a basic 80286 computer with a 40 megabyte hard drive to a 80486dx33 using OS/2. The author's system is an 80386dx33, 8 megabytes of memory, a 210 megabyte hard disk and using DesqView 2.62. Communications Output Labtest's serial communications are conducted using OpenDoors 5.0b10, by Brian Pirie. All communications are managed by the resident Fossil driver. Modem speeds from 2400 - 14.4k baud have been tested. Slow speed modems have the worst performance due to the fact that Labtest is very fast and the output to the remote terminal doesn't appear to 'keep up.' However, under testing, the output was near perfect, with the exception of a few dropped characters. This peculiarity is being worked on constantly. However, with the flow of modem users going away from 2400 baud, this is not anticipated to cause problems. Memory Swapping Labtest may use EMS memory for the swap file when running your 7 Labtest 3.2 User's Guide external programs if it is available. If not, Labtest will swap to disk instead. If you are using DesqView, it is recommended that you make an additional 400k of EMS/XMS memory available to Labtest to enhance performance. When Labtest has swapped out of memory, a small segment (less than 300 bytes) is left in memory to reload Labtest when the external process is completed. External programs Labtest uses many external programs which you will define in LTSetup. Following is a list of archive utilities that Labtest currently supports PKZIP 2.04g ARJ 2.41a LHA 2.22 PAK 2.51 PKPAK/PKUNPAK 3.61 PKARC/PKXARC 3.5 LHARC 1.13 RAR 1.50 beta ZOO 2.01 UC2 (Ultra Compressor II) Also, Labtest has been tested with the following virus scanners: McAffee's VirusScan (V.119 and 2.0) Frisk Software's F-Prot MicroSoft Anti-Virus ThunderByte Anti-Virus 3 Installation Labtest 3.2 is distributed in an archive file using the base name of LABTST32. You should follow these easy steps to ensure a flawless installation: Create a directory where Labtest and its associated files are to reside: MD LABTEST 8 Labtest 3.2 User's Guide After you have created this directory, change to it by typing: CD LABTEST Labtest comes preconfigured using the directory name C:\LABTEST for all of its paths and filenames. You would relieve your self of a great deal of effort by sticking to this default, else you will have to reenter all of the pathnames into LTSETUP. You will want to add the LABTEST directory to your path statement in your AUTOEXEC.BAT file. Load the AUTOEXEC.BAT file into your favorite editor, and locate the line containing the PATH= statement. Add your LABTEST directory to the end of this line. Unpack the distribution archive into your newly created Labtest directory. If you are installing Labtest 3.2 over an older version, it is strongly recommended that you make a backup copy of your previous version and ensure that you REMOVE the LABTEST.CFG file. Version 3.2 uses a new configuration file format and older formats will not be translated. If you attempt to load a configuration file for any other version, Labtest and LTSetup will inform you of this error. Once you have unpacked the archive, execute LTSETUP.EXE to begin configuring your copy of Labtest 3.2. Each individual option and command is described in the following pages. Labtest and LTSetup expect all of the files they will be using to be in the same directory as LABTEST.EXE and LTSETUP.EXE. You do not need to set any environment variables specifically for Labtest. However, you will need to ensure that your BBS environment variabls are set for proper use with the BBS software. For further information regarding these environment variables, please read the SYSOP.DOC file contained in your distribution archive. Please Note: Whenever you make a change to your BBS configuration, it is important to run LTSETUP so the new 9 Labtest 3.2 User's Guide changes will be adopted. Failure to do so will result in, let us say, interesting results! After you have unpacked your copy of Labtest, configuration is the next step. 4 Menu Navigation LTSetup is written using TCXL 6.12 from Innovative Data Concepts. The menu design closely mimics that of RemoteAccess and FrontDoor so you should feel immediately familiar. The TOP menu is a horizontal pulldown menu. You may move the selection bar left and right by using the left/right arrow keys. To select an option, you 'pull' it down using the down arrow key (or hit enter). Lower menus are called vertical menus. The left/up and right/down keys move the menu bar up and down respectively. Two types of items are available throughout the menu structure. Items you 'toggle' and items you 'select'. You may toggle an item by moving the menu bar to the desired item and pressing enter one or more times. Each successive 'enter' will change the item's state. Some items have up to six choices. Press enter until the desired choice appears. The item will maintain this choice, or state. Selectable items are items that will cause an action, open an input field or pop up another window, when selected. You may also use your mouse if you have one connected. The left mouse button is the 'enter' key and the right button is the 'esc' key. You may close a menu window by hitting Esc at any time. If you press ESC while at the TOP menu, LTSetup will exit. Once you have completed the configuration stage of LTSetup, you may select files to process from the Process Files menu. Or you may exit LTSetup and run Labtest from the command line. Complete details on running Labtest, from LTSetup, online and from the command prompt, will be discussed later. LTSetup contains a complete, context-sensitive, help system available at anytime by pressing the F1 key. A help window will appear describing in detail the current menu or menu item. You 10 Labtest 3.2 User's Guide may use your mouse and click on the Help Index button to get a complete index of all entire help system. 5 Configuration Options Now we get to the heart of configuring Labtest 3.2! Files/Paths This menu contains the bulk of the filenames and paths that control where Labtest will store some items and where it can find special files. Log File Path This is the drive and path where Labtest should write the LABTEST.LOG and UPLOAD.LOG files. The actual name of these files depends on whether or not you are running a multi-line system. Enter only the drive and path. If you are running a multi-node system, the log file names will be somewhat different. Instead of using LOG as the file extension, the actual node number will be used instead. This will prevent information from various nodes on your system from being mixed up. For example, the log file on node three would look like this: C:\LABTEST\LABTEST.3 Provided you specified C:\LABTEST as your log file directory. The log file for all local processing will always be LABTEST.LOG. Swap Path Specify the complete drive and path where Labtest should store its temporary swap file when executing external programs. Bad File Path Specify the drive and path where Labtest should place files 11 Labtest 3.2 User's Guide which fail the checks Labtest runs. If this path is defined in your FILES.RA, the database will also be updated. ANSI Screen File Specify the path and file name of the .ANS screen Labtest should display to your ANSI callers when processing a file. This screen will also be used for the local display regardless of the user's display capabilities. Labtest reserves the very top line of the screen to display registration and copyright information to the user. Each of your display screens must not use this line, as it will be overwritten. NOTE: If you enable the Remote Status Window option, this file must not display more than 17 lines on screen. The Remote Status Windo is never available for ASCII callers or callers using a RIP terminal. ASCII Screen File Specify the path and file name of the .ASC screen file to display to callers not supporting RIP or ANSI graphics. RIP Screen File Specify the path and filename of the .RIP screen file to display to callers supporting RIP graphics. Labtest will display the .ANS screen on the local terminal while displaying RIP graphics to the remote caller. Screen Control File Specify the path and file name of the .CTL file which Labtest will use when displaying information to the screen. This control file contains information such as colors, coordinates and text to be displayed during the processing. This file is required. An example control file is included in the distribution archive and contains detailed information on how to modify the user display. 12 Labtest 3.2 User's Guide Kill File List This file should contain file names (or wildcards) of files you wish to be removed from EACH archive and imbedded archives. For example, specifying RUSTY.* will remove all files that match this file mask. Here are some examples of valid filenames: RUSTY.* BBSAD.TXT -CALL-US.NOW Filenames containing paths are considered invalid: C:\LABTEST\BBSAD.TXT Add File List This file contains full paths and file names of files you want to be added to each archive processed. This is just the oposite of the Add File List, in that you must specify full paths, and wildcards are not allowed. Please note that it is not considered ethical to add files to archives, as this may give the impression that the files were added to the archive by the author of the program and may unfairly reflect negatively on the program and the author. Please do not abuse this option. Page File Name Specify the path and file name of the RemoteAccess compatible page file Labtest should use as a virus alarm. This is ignored if you set Sound Alarm to No (described later) or if you have the Scroll Lock key on. See the file PAGE.FIL in the distribution archive. Hack File Name Specify the path and file name of the HACK .COL or .IDX file Labtest should search. This file should contain base file names of files you do not want on your system. Labtest is capable of reading and parsing the Hack Report .IDX and .COL 13 Labtest 3.2 User's Guide files without modification. The current version of the Hack Report is always available for downloading from the Labtest Headquarters BBS. Archive Comment File Name This is the path and file name of a text file you want added as an archive comment to each file Labtest processes. If you do not want ANY archive comment added, leave this field blank. You may optionally add the contents of the FILE_ID.DIZ as an archive comment. Inbound TIC Directory This is the directory where your inbound .TIC files are placed by your mailer software. In implimenting .TIC processing in Labtest, our goal was to provide the ability to get the file information into the BBS and have the files processed by Labtest. If you specify /TIC on the command line or select Process .TIC files from LTSetup, Labtest will look for any inbound .TIC files in this directory. If any are found, each .TIC file will be read and parsed for the file name, description, and destination file echo area. Labtest then reads your .TIC configuration file and gets the physical destination directory from there. This process is repeated for each .TIC file. If Labtest is interrupted at any time, the most that could happen is you may lose the .TIC file that was being processed at the moment of the interruption. For details on setting up Labtest to handle your .TIC files, please read the SYSOP.DOC included in your distribution archive. Duplicate File Database Enter the path and file name of the file to use as your duplicate file database. This file will be searched for 14 Labtest 3.2 User's Guide possible duplicates for each archive that is unpacked. Many sysop's like the ability to be able to check for duplicate internal files. This will prevent users from simply renaming an archive and uploading it to you just to steal upload credits. You may leave this blank if you do not wish to use this duplicate checking feature. Please note that on large systems with numerous files, this feature may impede performance. Note: This file is not a text file. It contains the CRC values for the file names that Labtest has processed. This method was chosen to increase speed as well as reduce overall file size. Each file name will occupy four bytes instead of the full file name of up to 12 characters. Anti-BBS Ad Text File Labtest now can check INSIDE files for text strings that are normally only found in those pesky BBS advertisements. Specify here the path and file name of a text file containing words or phrases to search for in files contained in archives. You can also set the maximum file size to check to enhance speed and operation. You can set Labtest to delete BBS advertisement files if you like. This is not really recommended because not all files which may fail this check are actually advertisements. Other than deleting the files and making a note in the logfile, Labtest does nothing more for advertisement files. The archive will not be failed due to the existence of an advertisement file. Editor Command Enter the path and file name of your preferred Default Text Editor. LTSetup will still pop up a list of editors found in your DOS path, but your preferred editor will always appear at the top of the list, so all you need to do is hit enter when the editor list appears if you wish to use the default. BBS Interface This menu controls how Labtest interfaces with your Bulletin 15 Labtest 3.2 User's Guide Board Software. If you are not running a BBS, or you are running a BBS that is not directly supported by Labtest, then some of the options on this menu will be of little use to you. Please refer to the file SYSOP.DOC for details on installing Labtest into your BBS system or using Labtest when you do not have a BBS. * NOTE * It is extremely important to re-select the Sysop and User message areas each time you change the BBS System Type. Failure to do so will result in undefined results! Sysop Message Board This is the message board number where messages addressed to the Sysop will be placed. Labtest's message writing routines support Squish, Jam, Hudson, GoldBase and *.MSG formats. User Message Board This is the message board number where messages addressed to the User will be placed. Set Security Level If you specify a number other than zero '0' in this field, Labtest will lower the user's security level to this number if a virus is detected in the uploaded file. Please note that this is an extremely effective tool to deny user's upload rights should they upload a virus to your system. It is each user's responsibility to ensure that the files they upload are clean. Several states have laws providing punishment for people who 'knowingly or unknowingly' transmit computer viruses. Using this option will ensure that they cannot continue uploading until you grant them access again. Add Uploader Name Labtest can optionally add the name of the user who uploaded the file being processed to the file's description. You may disable this feature here, or you may also disable it from the command line using the /- switch. This switch 16 Labtest 3.2 User's Guide temporarily disables this feature and is in effect only for the current session. Remote Status Window While processing a file, Labtest writes a great deal of information to the system logfile. This information may also be displayed to the sysop and the user display in a box at the bottom of the screen. If you enable Remote Status Window, be sure that your custom ANSI screen file does not have any pertinent information in the screen region below line 17. BBS System * NOTE * It is extremely important to re-select the Sysop and User message areas each time you change the BBS System Type. Failure to do so will result in undefined results! Labtest 3.2 will support RemoteAccess 2.xx, ProBoard 2.01, QuickBBS 2.80 (GoldBase and Hudson) and any system using the well-known FILES.BBS file information system. If you are running a system which supports or uses the FILES.BBS system, selecting FILES.BBS as your system type will ensure that Labtest updates your FILES.BBS whenever it processes a file. Please refer to the file SYSOP.DOC for detailed information on installing Labtest into your BBS software, or for information on running Labtest without a BBS. Description Offset Value When using Labtest on a FILES.BBS system (not ProBoard 2.01), you may wish to specify a column number for file description continuation lines. Labtest does not write the entire description to one line, as some BBS systems do. Instead, Labtest maintains the original format of the description and provides a means of indenting the continuation lines. For most systems, this value should be 32 (column 32). This will require some testing on your part 17 Labtest 3.2 User's Guide to find a value that is ideal for your system. Specifying 0 will cause continuation lines to begin at the immediate left of the screen, or column 1. Description Continuation Character Many systems using FILES.BBS may use a special character to precede each continuation line, informing the system that the line is part of the description and not a comment line. Here you will insert the character that you wish to precede each description continuation line. For Proboard, you should enter the '+' character. Additionally, if you are using Proboard, you should specify 0 as your Description Offset Value. Many other systems use the pipe symbol '|' to precede continuation lines. If your Description Offset Value is not 0, the lines will be filled to the left with a space, then the Description Continuation Character will be inserted immediately before the description line. User Message Setup If you are using a BBS system that is directly supported by Labtest, you have the option of posting messages to your callers concerning the file they have uploaded. In the distribution archive you should find several *.MSG files. These files contain text which will be imported by Labtest into the message base. These messages may be totally customized by you to give your system a personal touch. There are a few macros which will be expanded by Labtest during reading of the message file. These macros must be specified in upper case, with the @ symbol on both sides, excactly as shown. These are explained below: @SYSOP@ Sysop name (as defined in RACONFIG) @BBS@ System name (RACONFIG) @USERFIRST@ First name of the user @FULLNAME@ Full name of the user @UPLOADS@ Total number of uploads the user has posted @UPLOADK@ Uploads (in K) the user has posted @AGE@ Maximum age in years for files 18 Labtest 3.2 User's Guide @GIFRESOLUTION@ Minimum acceptable GIF resolution @UPLOADFILE@ The name of the uploaded file. @FILENAME@ Same as above. @VIRUSINFO@ Information about the virus detected. Keep in mind the width of each of these macros when they are expanded. Labtest will not word wrap the text and it may look choppy if your text lines are too long. Note: If you do not want a specific message to be written to the user, do not specify a path or file name for that message file. It is important to adhere to this rule due to the way messages are written by Labtest. The message text for each Sysop Message is defined in the LABTEST.LNG file, therefore you could modify your LABTEST.LNG file to add any of the macros you would like to use. All Ok Message Specify the path and file name of the file to be imported informing the user that the uploaded file passed all phases of Labtest. Virus Message Specify the path and file name of the file to be imported informing the user that the file failed the virus scan. Bad Gif Message Specify the path and file name of the file to be imported informing the user that the .GIF file failed the resolution test. Bad File Message Specify the path and file name of the file to be imported informing the user that the file could not be processed by Labtest. Old File Message 19 Labtest 3.2 User's Guide Specify the path and file name of the file to be imported informing the user that the file failed the age test. Hack Report Message Specify the path and file name of the file to be imported informing the user that the file was found among those listed in the Hack Report. Dupe File Message Specify the path and file name of the file to be imported informing the user that the file failed the duplicate file test. Sysop Messages Labtest can write a short note to the Sysop concerning the status of the files it processes when used online (from the BBS). You may turn on or off any of these messages by selecting Yes or No at the appropriate Sysop Message menu prompt. Each of the macros described above are also available for use in the Sysop messages. The text for the Sysop messages is contained in the file LABTEST.LNG. This file contains all of the text used throughout Labtest and LTSetup. You may enter up to 256 characters for each of the Sysop messages. If you wish to force a carriage return a any point in the message text, place a reverse single quote (`) at the position where you would like a carriage return to appear. File Comments Labtest can append a short note to the file description concerning the status of the file. You may turn on or off any of these notes by selecting Yes or No at the appropriate File Comments menu prompt. These are similar to the Sysop messages. Hint! If a user uploads a virus infected file, Labtest may be able to determine what the actual virus was that was 20 Labtest 3.2 User's Guide found by your virus scanning utility! Also, if it can determine the name of the virus, Labtest will write this information to your Sysop message, User message AND the file's description! You must be using a virus scanner which can write information to a report file, and have the report file name specified on the command line in order to take advantaged of this feature. Control Menu This menu controls the overall operation of Labtest. Sysop Name Enter your name as it appears on your registration form. This field is case sensitive, therefore upper and lowercase letters are not treated the same, so be sure to double check your registration form. Registration Key Enter your registration key as it was provided to you. Max File Age Specify in years the maximum desirable file age. Labtest will fail files older than this. Set to 0 to disable age checking. Sound Virus Alarm Specify Yes if you want Labtest to alert you (using the Page File), in the event a virus is detected in the user's upload. This will be ignored if you do not have a Page File defined in Files/Paths or you have your Scroll Lock key on (A RemoteAccess convention adopted by Labtest for consistency.) Swapping method While executing external programs like PKZIP or SCAN, Labtest needs to free up the memory it uses by performing 21 Labtest 3.2 User's Guide what is called a swap. Labtest copies its program image to disk or EMS memory and loads the external program. When the second program is finished, Labtest reloads and continues execution. You have three options for swapping Labtest out of memory, NONE, EMS and DISK. None is normally used only in testing. EMS will copy the image to extended memory, and DISK will copy the image to the swapping directory specified in your files/paths section. If you are using a RAMDISK, select DISK here and specify the RAMDISK path in your files/paths setup. DOS Window Height Many sysop's have asked for a way to adjust the DOS window size. This option will set the number of screen lines that the DOS window should occupy. This does not change the location of the window, which will always END on line 23. If you specify 12 here, the DOS window will begin at line 11 (23-12) and end on line 23, taking up the screen region from the left edge to the right edge. The colors of the DOS window are not yet adjustable, but may be in a future release. GIF Options These options only apply to .GIF or .JPG files and control how Labtest will process these files. Note: Labtest cannot determine the graphics resolution of a JPG file. There is no set standard for resolution testing for JPG files and determining the resolution is beyond Labtest's current capabilities. Check GIF Age Specify whether you would like Labtest to check the age of GIF files according to the Max. File Age setting (described above). 22 Labtest 3.2 User's Guide Minimum GIF Width Enter the minimum acceptable width in pixels for .GIF and .JPG files. Minimum GIF Height Enter the minimum acceptable height in pixels for .GIF and .JPG files. Minimum GIF Colors Enter the minimum acceptable number of colors for .GIF and .JPG files. GIF Separator Character Labtest will write the GIF color resolution to the file description in the format width X height X colors. The separator character is the character you want to be put in between each of the resolution factors. For example, if you specify * as the separator, your GIF descriptions will look like this: (640*480*256) Compress GIF Files Labtest can compress a GIF file using the compression program specified in Archive Definitions if you specify Yes here. Compressing GIF files may save you a large amount of disk space, at the cost of a (generally low) degree of resolution loss. Alternatively, you can choose to Uncompress JPG files as well. Uncompress JPG Files If Labtest detects a JPG file (essentially a compressed GIF), it may be able to uncompress the file, restoring it to GIF. Specify Yes here if you wish to do this. Restoring JPG files will not restore them to their original resolution. JPEG compression is not a loss-less method, and compressed files suffer somewhat in their resolution. 23 Labtest 3.2 User's Guide Archive File Menu This menu contains all the necessary info for Labtest to process archived files. Default Archive Type Specify the three letter extension of the default archive format. This is overridden by your FILES.RA default archive format. If you prefer all your files to be of the same type, you may leave the default archive field blank in all of your file areas, and specify it here instead. You must specify the default archive type if you are not using RemoteAccess. Maximum Old File Percentage Specify the overall maximum percentage of old files the archive can contain before it will be considered a fail. This extends to imbedded archives and all files contained in all subdirectories, of all archives.....You get the drift. For example, specifying 80 here would fail the archive after 80 percent of its files are found to be too old. File Date Options Labtest will date the archive according to one of the following: Newest File: The date of the newest file is used as the archive date. Oldest File: The archive is stamped with the date of the oldest file. Keep Date: Labtest will keep the original date of the archive. System Date: Labtest will date the archive with the current system date. 24 Labtest 3.2 User's Guide Convert SFX Files If the file being processed is determined to be a self extracting file, Labtest can either unpack/scan/convert the file or ignore it altogether. If you set this option to No, Labtest will archive the file in your default archive type. For example, if a user uploaded LABTST29.EXE which is an SFX file, and you had this set to No, Labtest will create an archive called LABTST29.ARJ (assuming ARJ is your default archive type), containing just one file, LABTST29.EXE. Pack Unknown Files If Labtest is unable to determine the file type, it can compress it using the default archive format. This will save space on your computer if users upload large text files in an effort to steal upload credits. Specify No to leave unknown files in their original state. Keep Security Labtest can detect and honor the security envelopes of ARJ and ZIP files. If you specify Yes here, Labtest will unpack and scan the files, but will not attempt to repack or add a comment to these files. This applies to imbedded archives as well. Imbedded Archives Here you may specify how Labtest should handle imbedded archives. An Imbedded Archive is defined as an archived file contained within an archived file. The imbedded archive options are described below: Ignore: Do nothing to imbedded archives. Scan: Scan imbedded archives. Do not rearchive. Rearc: Rearchive imbedded archives. Do not scan. Scan/Rearc: Scan and rearchive imbedded archives. 25 Labtest 3.2 User's Guide When Labtest processes an archive containing a directory tree, each subdirectory will also be processed, checking for more archives and also performing all other tests performed on the basic archive. There is no 'built-in' limit to this capability. Process Descriptions Labtest can modify the description found in the FILE_ID.DIZ (or DESC.SDI) file. The purpose of this is to remove high ASCII characters such as those used for boxes and other special characters. Maximum File Size You may define the largest file size in kilobytes that Labtest should attempt to handle. Files exceeding this size are ignored. This applies only to archive files and not .GIF/.JPG files. Set this option to 0 to disable Maximum File Size checking. Maximum Duplicate Files Specify the maximum number of duplicate files allowed in an archive file. If the uploaded file contains more duplicate files than this number, it will be failed. Keep in mind that files received through a file network often 'replace' other files and may fail this test. Set this option to 0 to disable duplicate file checking. Maximum Duplicate File Percentage Specify the maximum percentage of duplicate files allowed before Labtest will fail the archive as a duplicate. This can be used instead of or in conjunction with the Maximum Duplicate Files option. Maximum Advertisement File Size Specify the maximum file size to check for BBS ads. BBS ads are usually small, so setting this to about 500 is normally sufficient. Files larger than this size will be skipped. 26 Labtest 3.2 User's Guide Each file in each archive is checked against your Anti-Ad file text. Set to 0 to disable Advertisement File checking. Delete BBS Advertisements Files which failed the advertisement check may optionally be deleted. Select Yes if you wish to delete these files. Use this option with caution. Not all files which will fail your anti-advertisement test may be BBS ads! Labtest will not fail the archive solely based on the existence of an advertisement file. Adjust User Credit Specify if you would like Labtest to adjust the user's upload credit for the new file size after conversion. Failed Scan Action Here you will specify the action Labtest should take on files that fail the overall processing. Each option is described below: None: Labtest will not do anything in the event of virus detection. Unlisted: Labtest will mark the file as unlisted in your file database. Not Available: Labtest will mark the file as not available. Mark Deleted: Labtest will mark the file as deleted. Move: Labtest will move the file to the path specified in Files/Paths - Bad file path. Move/Unlisted: Labtest will move and mark the file unlisted. Move/Notavail: Labtest will move and mark the file not available. 27 Labtest 3.2 User's Guide Most of the above options apply only to RemoteAccess 2.xx which uses a database system instead of FILES.BBS. If you are using ProBoard or another FILES.BBS system, the only options that are available are None and Move. Move/NotAvail and Move/Unlisted are not available. Archiver Setup This menu contains the information needed by Labtest to run your external archive utilities. Labtest is preconfigured for the more popular archive utilities and associated command lines. However, you may change these as you wish. To skip to the next archiver, press the Page Down key (or use your mouse and click on the PgDn button. To skip to the previous archiver, press the Page Up key, or click on the PgUp button. Press ESCape when you are done. Archive Extension This is the three letter file extension used by the archive utility. Labtest is designed to detect almost all of the most popular archive formats based on the unique archive signature used by each program. This extension is used to find a match in an internal table of probable extensions based on the archive type. This extension is only used when rebuilding a file name during the conversion phase; it is not used during the unpacking or archive detection phase. If you are using an archive utility that Labtest does not recognize, please send the complete distribution archive for the program, and we will install the necessary information into Labtest to automatically detect the archive type. Unpack Command Line This is the command line that will be executed by Labtest to unpack, or decompress, files of this type. You should specify the path/program name, command line options and the @ character which will be replaced by Labtest with the full file name, including drive and path. The @ character should be in the correct position in the command line, just as you would execute it from DOS. If you specify only the program name without a path, Labtest will attempt to find the 28 Labtest 3.2 User's Guide program in your DOS path and fill in the entire path/file name for you. You may wish to do this especially when you are installing Labtest for the first time or upgrading from a previous version. To ensure correct path names, press enter on each of the Pack/Unpack/Comment prompts and Labtest will do the rest for you. Some example ARJ: C:\SHEZ\ARJ.EXE x -y @ PKUNZIP: C:\SHEZ\PKUNZIP.EXE @ -d ZOO: C:\SHEZ\ZOO.EXE e @ LHA: C:\SHEZ\LHA.EXE e @ PKUNPAK: C:\SHEZ\PKUNPAK.EXE @ UC II: C:\SHEZ\UC.EXE ES @ Pack Command Line This is the command line that will be executed by Labtest to pack, or compress, files of this type. You should specify the program name, command line options, and the @ character which will be replaced by Labtest with the file name. The @ character should be in the correct position in the command line, just as you would execute it from DOS. Some example command lines follow: ARJ: C:\SHEZ\ARJ.EXE a @ -r -jm PKZIP: C:\SHEZ\PKZIP.EXE -a @ -rp -ex ZOO: C:\SHEZ\ZOO.EXE a @ LHA: C:\SHEZ\LHA.EXE a @ PKPAK: C:\SHEZ\PKPAK.EXE -a @ UC II: C:\SHEZ\UC.EXE AS @ Comment Command Line This is the command line that will be executed by Labtest to add an archive comment to archives of this type. You should specify the program name, command line options, and the @ character which will be replaced by Labtest with the file name. The @ character should be in the correct position in the command line, just as you would execute it from DOS. You may place the contents of the FILE_ID.DIZ (if found) as the archive comment or you may place the DIZ contents AND 29 Labtest 3.2 User's Guide the comment file. Labtest uses two macros, $COMMENT$ and $DIZ$ for these purposes. You may place the FILE_ID.DIZ before the comment file or after it by switching the position of these macros. Here are some examples using ARJ: ARJ.EXE c @ -z$DIZ$ $COMMENT$ ARJ.EXE c @ -z$DIZ$ ARJ.EXE c @ -z$$COMMENT$ ARJ.EXE c @ -z$COMMENT$ $DIZ$ NOTE: We have discovered that in order to use PKZIP to add an archive comment, it must be called using COMMAND.COM in the beginning of the command line. The reason for the change is Labtest's internal method of calling programs does not work for programs that use the dos REDIRECTION '<' symbol. To add a comment to a PKZIP archive, the following command line is required: C:\COMMAND.COM /C C:\SHEZ\PKZIP.EXE @ -z<$COMMENT$ $DIZ$ Of course, the path for PKZIP may be different for your system, and the COMMENT DIZ specifier is up to you. This is just an example but the important piece of information is the C:\COMMAND.COM /C must appear before PKZIP.EXE in the command line. PKZIP is the ONLY program that requires this change. (This only applies for the Comment Command Line. Pack/Unpack command lines do not require this.) Video Full Screen: Labtest will save the screen, clear it, run the external program, and restore the screen upon return. DOS Window: Labtest will run the program in an adjustable window. All of the program's output will be restricted to this window. Some programs perform direct screen writes and are not compatible with the DOS window. Labtest must find the program DOSWIN.EXE in the same directory as LABTEST.EXE in order for the DOS window to be used. The size of the DOS window is adjustable. See the Control Menu, DOS Window Size. 30 Labtest 3.2 User's Guide Disable Video: Labtest will disable all video while running the external program. This is the most stable view. It may, however, only work on VGA or better systems. The only way to determine out what's best for you and your system is to try until you find the one you prefer most. NOTE: While being the most stable view, Disable Video temporarily disables the entire video system of your computer, regardless of the operating system you are using. This has resulted in the impression that the system was locked up under a multi-tasking system (OS/2 or DESQview), when indeed it was not, but the video had been disabled by Labtest. The video is enabled upon return from the external program. The recommended video method is DOS Window, as it is compatible with almost all archiving and virus utilities and provides a window where you can watch what is happening. Virus Scanner Setup Labtest can be configured to run up to 20 virus scanners, in succession, on each uploaded file. Each virus scanner will be executed in the order they have been defined. The errorlevel returned will be written to the log file. To skip to the next virus scanner, press the Page Down key (or use your mouse and click on the PgDn button. To skip to the previous virus scanner, press Page Up key, or click on the PgUp button. Press ESCape when you are done. Scan Command Line Specify the command line to run your desired virus scanner. The full path is required for all external programs. If you are using a virus scanner which has the ability to log the information regarding the files it has scanned, Labtest may read this information and write it to the log file. To enable this option for McAfee's SCAN, specify /REPORT $REPORT$ option on your command line. The /REPORT tells Scan to create a report file and the $REPORT$ is a macro used by Labtest to specify the file name to the virus scanner. Labtest creates this file name at run time to prevent interference from other nodes. If you use /REPORT, 31 Labtest 3.2 User's Guide you must use $REPORT$ or Labtest will not read the results from the report file that Scan creates. F-PROT uses a similar format for specifying the report file. Use /REPORT=$REPORT$ for F-PROT. Errorlevels Specify one or more errorlevels that may be returned by this scanner in the event a virus is detected. Some virus scanners may return a different errorlevel for different types of viruses. By specifying each errorlevel separated by a space, you can test for any virus level the scanner may return. Errorlevels other than those specified will simply be logged and will be considered a pass. Check your virus scanner's documentation for the appropriate errorlevels to use. Examples of errorlevels that you would not specify here are those that indicate low memory, bad command line, or no files found to scan. These should be considered as warnings and should not cause Labtest to fail the file. For more information on program errorlevels, please review the information appearing at the end of this documentation, External Program Errorlevels. Video See section 5.6.5 Video options Enable You may enable or disable each of your virus scanners by setting this option to Yes or No. Setting it to No means that this virus scanner will not be used. Using this option, you may configure many virus scanners, but only actually use selected ones each time Labtest runs. Scan Log Text Many virus scanners have the capability to create a logfile containing information about the scan session. Labtest can read this file and write the information pertaining to an infection to the log file and the sysop/user messages. 32 Labtest 3.2 User's Guide Using the Log Text feature, you will specify one or more words or phrases that are contained in the virus scanner's report file which indicate a virus has been detected. Separate each word or phrase with a space. If you wish to search for a multiple word phrase, i.e. "Virus Found", use an underscore '_' character as a substitute for the space between the words. Labtest will translate the underscore to a space before performing the search. For example, F-PROT writes something like: VIRUS.EXE Infection: Jerusalem.1808.Standard to the REPORT file. The keyword here would be 'Infection'. Case is relevant, so be sure to specify the word exactly as it appears in the report file. McAffee's VirusScan reports something like: Found the Jerusalem [Jeru] Virus Labtest will write the entire line which contains the selected words or phrases. So you would specify 'Found' as the log text for SCAN.EXE. You can experiment with this and see what suites your needs best. Labtest will write a file called SCANRPT.nnn (nnn is the node number, 0 = Local Node) in the Labtest directory during each run. Check this file for the appropriate words or phrases. 6 Using LTSetup to Process Your Files You may utilize LTSetup to select and process your files or file areas from the Select Files or Select File Areas menu. Select Files Selecting this option will open a window of file names from the current directory. You may tag as many of the file names as you like. Press ENTER when you are done selecting files. 33 Labtest 3.2 User's Guide Select File Areas This menu is currently supported only for ProBoard 2.xx, RemoteAccess 2.xx and QuickBBS 2.80 systems. If you have selected FILESBBS as your system type, this menu option will be disabled. This menu will open a window of your defined file areas and you may tag the areas you want processed. Each file in the tagged area will be processed according to the settings you have defined. CD-ROM Support If you are selecting CD-ROM areas to process, be sure that you have selected any non CD-ROM areas you want processed before you select the first CD-ROM area. Labtest will default to No Rearc, No Comment, and No Move when processing CD ROM areas. Additionally, the Add Uploader Name is disabled when processing CD ROM areas. These defaults remain in effect until Labtest exits. To allow you to alter Labtest's default behavior for the current session, you may select one of the options below and toggle it to Yes or No. This will only affect Labtest's behavior while run from within LTSetup. These options are the equivelant to the command line options discussed later in this manual. Convert This option defaults to Yes. If you toggle this to No, it is the same as specifying /NC (No Convert) on the command line and will inform Labtest that it is not to convert files to the default archive format during this session. Scan This option defaults to Yes. If you toggle this to No, it is the same as specifying /NS (No Scan) on the command line and will inform Labtest that it is not to run any of the defined virus scanners during this session. 34 Labtest 3.2 User's Guide Override This option defaults to No. This informs Labtest that it should not process files which have already been processed. Labtest keeps track of which files have already been processed by any other version of Labtest. If the file is modified in any way, Labtest will consider it to be a new file, subject to processing. If you run Labtest by selecting file areas, it is highly recommended that you leave this set to No. If it is toggled to Yes, Labtest will process ALL files in the selected areas which could result in a rather lengthy task if you have many files. Process .TIC Files Selecting this option will start Labtest in .TIC processing mode. This is the same as specifying /TIC on the command line. You may use this in conjunction with selecting files and file areas. Begin If you have selected files or file areas to be processed, selecting this option will fire up Labtest to go to work. 7 Printing/Exporting Your Configuration File You may wish to print a copy of your configuration file once you have installed Labtest. Select the Quit Menu. The Export Config File option will open a window asking you how you want the information exported. If you wish to print the configuration file to the printer and write it to a text file, press B for Both at the prompt. If you wish to only print the configuration, press P for Printer. To simply export the configuration information to a text file, press F for File. LTSetup will prompt you for the file name to save the information to. If this file exists, it will be overwritten. NOTE: Never specify the same file name as your LABTEST.CFG file when exporting the information. Labtest's configuration file is not a text file, and overwriting it will cause you to re-enter all of the information. 8 Customizing Labtest's Displays 35 Labtest 3.2 User's Guide Labtest can display information in one of three display modes, RIP, ANSI, and ASCII. Labtest detects the remote user's terminal capabilities by checking the BBS door information file (usually EXITINFO.BBS or DOOR.SYS). Note that RIP display is available only on the remote terminal. Labtest will attempt to display ANSI to the sysop's terminal if the user has a RIP terminal. You may wish to modify the display screens to suite your tastes. In addition to drawing your screens, you need to tell Labtest where to put the information on the screen to reflect each stage of the process. This is accomplished by using the Screen Control File. This file is named LABTEST.CTL in the distribution archive and contains all the information you need to customize your display. Refer to that file for more information. 9 Running Labtest There are several command line options you will need to be familiar with in order to run Labtest from the command line. /L Local Mode. Informs Labtest that it is not to read the door information file (EXITINFO.BBS/DORINFO1.DEF) and that no communication with the modem is to take place. /G Configuration file name. Specifies an alternate configuration file to load. Instead of using this command line, you may wish to use the alternate naming method for your configuration files. You may name your configuration file by using the current node number. For example, creating one configuration file for each node (not normally required), you would place all of these files in your Labtest directory. The default is always LABTEST.CFG. It will be read last. If Labtest finds a file named LABTEST.Cxx, where the xx is the node number, that file will be loaded. If this file does not exist, LABTEST.CFG will be loaded instead. /O Override Mode. Informs Labtest that it is not to check for previously processed files. Files already processed by Labtest will be re-checked. This is recommended when running under the BBS. If you are running in Local Mode, you may want to leave the /O switch off, unless you are sure you want to re-process files. /E EXITINFO Path. Informs Labtest of the location for your 36 Labtest 3.2 User's Guide EXITINFO.BBS file. Normally not needed if the file is in the current directory. /N Node Number. Labtest normally reads the node information from the BBS drop file. If it cannot correctly determine what node you are operating on, you may force Labtest to use a specific node number by specifying the /Nnnn command line option. nnn indicates the node number. Do not precede the node number with any spaces or zeros. Usually, the BBS will have some provision for specifying the node number on the command line. RemoteAccess uses *N to indicate the node number, so specifying /N*N on the command line will pass the node number to Labtest. /NS No Scan. Prevents Labtest from scanning for viruses. Useful if you want a quick import of the file information/description. /NR No Conversion. Prevents Labtest from converting files to the default archive format. Useful if you want a quick import of the file information/description. /NC No Comments. Prevents Labtest from adding the archive comment. /ND No Delete. Prevents Labtest from removing the .TIC files and their accompanying after it has processed them. Labtest will mark the .TIC as having been processed, so if you run Labtest again with the /ND command, it will not reprocess the .TIC file. However, if you do not specify /ND on the command line, Labtest will process and remove all .TIC files found in your inbound directory. /TO Tic Override. This is very similar to the /O command, forcing Labtest to process all .TIC files. This is particularly useful if you want to reprocess your .TIC files, but do not want them removed by using the /ND command. This command is only relevant when used with /ND. /NTR No Tic Replace. This will prevent Labtest from replacing any file named in the .TIC 'Replaces' field. This is a global command and its scope is the duration of the current session. Therefore, no replacement will be done for any .TIC files. 37 Labtest 3.2 User's Guide If you only have certain areas you wish to keep older versions of the file, you may specify that area as a No Replace Area in your TIC configuration file. /- No uploader name. Disables the writing of the Uploader's name to the file description. Useful when you are bulk processing files offline. Here are some examples of running Labtest from DOS: LABTEST C:\UPLOADS\LABTST31.ARJ /O /L Processes the file C:\UPLOADS\LABTST31.ARJ with Override on. You may specify more than one file name on the command line. LABTEST 89 /L Processes your file area number 89. Only new files will be processed since we did not specify /O. You may specify more than one file area on the command line. LABTEST C:\UPLOADS\*.* /L Processes the C:\UPLOADS directory. Only new files (files that have not been tested before) will be processed. You may specify more than one wildcard path on the command line. You must specify a wildcard if you specify a path without file names. Labtest wouldn't know if C:\UPLOADS was a file or directory. LABTEST /TIC /O Labtest will process your incoming .TIC files in your inbound directory as specified in LTSetup. Informs Labtest it is to re- check previously processed files (/O). You need not specify the /L local switch when using /TIC. Please note: If your inbound .TIC directory is, for example, C:\RA\FD\FILE, and you start Labtest with: LABTEST C:\RA\FD\FILE\*.* /L /O This is not the same as LABTEST /TIC /O. Labtest will only start 38 Labtest 3.2 User's Guide in .TIC mode if you specify the /TIC on the command line. Never run Labtest on your inbound .TIC directory without using the /TIC switch. You may, however, specify other file areas or file names in addition to /TIC: LABTEST 89 C:\UPLOADS\LABTST31.ARJ /TIC /L /O This would cause Labtest to process file area 89, LABTST31.ARJ, and your incoming .TIC files all in one session! For information on running Labtest from your BBS, please read the SYSOP.DOC file. 10 External Program Errorlevels Labtest will always record the errorlevel reported by an external program upon return from a shell. These errorlevels were captured from various documentation files from the respective program archives. PkZip 2.04g 1 :Bad file name of file specification 2-3 :Error in ZIP file 4-11 :Insufficient memory 12 :No files were found 13 :File not found. The specified ZIP file or list file was not found. 14 :Disk full 15 :Zip file is read-only and can not be modified. 16 :Bad or illegal parameters specified. 17 :Too many files. PkUnzip 2.04g 1 :Warning error (such as failed CRC check) 2-3 :Error in ZIP file 4-8 :Insufficient memory 9 :File not found. No zip files found. 10 :Bad or illegal parameters specified. 11 :No files found to extract/view etc. 50 :Disk full 39 Labtest 3.2 User's Guide 51 :Unexpected end of file in ZIP file. ARJ 2.41a 1 :Warning Specified file not found 2 :Fatal error 3 :CRC error 4 :ARJ-SECURITY error 5 :Disk full or write error 6 :Can't open archive or file 7 :Simple user error (bad parameters) 8 :Not enough memory LHARC 1.13c 1 :CRC error 2 :Fatal error. 3 :Failed to write temporary files in the archive. PKPAK 3.61 PKUNPAK 3.61 1 :Bad CRC warning 2 :Out of memory 3 :No archives found to extract 4 :Can't open archive file 5 :Read error on archive 6 :Internal table overflow 7 :Disk Full PAK 2.51 1 :CRC error 2 :Out of memory 7 :Disk Full McAffee's VIRUSCAN Version 9.20V109 EXIT CODES 0 :No viruses found 1 :One or more viruses found 2 :Abnormal termination (program error) 3 :One or more uncertified files found 40 Labtest 3.2 User's Guide 4 :Ctrl-C or Ctrl-Break aborted scan 11 Registration, warranty and licensing Upon registering Labtest 3.2, you will be provided a personal registration key. You will enter this registration key into LTSetup, which will then be recorded in LABTEST.CFG. Upon verification, Labtest will then run in registered mode, removing all 'nag screens'. Current registration prices are subject to change at any time without notice. At this time, we are not requiring upgrade fees. However, free upgrades are not guaranteed and this policy is subject to change according to customer demands and needs. This is a change from the previously published 'no upgrade fee' policy. In order to receive a registration key for version 3.2, you MUST use the enclosed registration form. Using older forms will result in processing delays. This program reflects the combined efforts of many people, none of which are being paid a salary for their work. This is the reason the price is being kept low enough for most sysops to easily afford. Although Labtest has no "Unregistered" features, you are nonetheless required to register if you continue usage beyond the 30 day trial period you are granted. By not registering, you are not only breaking a code of honor that the shareware community enjoys, you are in fact attributing to slower development and enhancements. When you register Labtest, you become part of a large team. This team communicates among eachother and with the author, providing a feedback network which stimulates not only the further development of Labtest, but fosters new ideas for other programs (Upload Partner and File Sorter to name just two). There are no guarantees in life. And Labtest is no exception. Although version 3.2 has undergone the most extensive testing of all versions since its inception, it is not guaranteed that Labtest will perform a function suitable to your needs, or that Labtest will even run on your system. The author is not responsible for any damage or loss of system resources due to the use or misuse of this product. Additionally, the author is not liable or responsible to any other party for damages or claims 41 Labtest 3.2 User's Guide made by the third party for any residual damages or losses, whether real or imagined. Basically, if you are an author, and you distribute Shareware in archived files, the author of Labtest is not responsible for a sysop's use of Labtest which may alter or add files to your distribution archives. 12 Customer Support Policy We may be contacted via Fido network Net-Mail, calling one of the support Bulletin Board Systems listed below, or by posting a message in on of the following Fido Network Conferences: RA_UTIL RemoteAccess Utilities Conference PROBOARD ProBoard Support Conference QUICKBBS QuickBBS Support Conference QUICKPRO QuickBBS Sysop Conference You may wish to use this method as the most economical means of obtaining answers to your questions, as there are many experienced Labtest users who frequent these conferences. North American Support Sites Scott Livingston 1:142/212@fidonet.org Phone Henge BBS BBS: (203) 673-6247 New Britain, CT Eddy Salvador 1:107/957@fidonet.org Integrated Circuits BBS BBS: (908) 354-4395 Elizabeth, NJ Glen Appleton 1:260/371@fidonet.org Psycho Ward BBS BBS: (315) 478-2042 Syracuse, NY Gary L. Murphy 1:130/85@fidonet.org The Recovery Corner II BBS: (817) 447-3580 Burleson, TX Hector Cintron 1:142/1778@fidonet.org U.S.S. Nautilus BBS: (203) 827-0280 New Britain, CT 42 Labtest 3.2 User's Guide William Brooks 1:264/415@fidonet.org Gameworld BBS BBS: (804) 261-0687 Glen Allen, VA Gary Petersen 1:280/389@fidonet.org Midwest Xpress BBS: (913) 894-8835 Lenexa, KS Marlin England 1:309/45@fidonet.org All Around the World BBS BBS: (602) 458-6371 Fort Huachuca, AZ Mark McNew 1:19/14@fidonet.org Sirius BBS: (501) 424-2510 Mountain Home, AR Scott Drake 1:107/922@fidonet.org The T.E.R.N. BBS BBS: (201)399-4772 Irvington, NJ 13 Registration Users may register Labtest by printing and filling out the registration form appearing at the end of this document or by entering LTSETUP and answering Yes to the prompt "Fill out registration now? Y/n" All registrations must be in US funds, either by check or money order drawn on a US bank. Make all checks or money orders payable to Mark Williamson. Expect 5 to 10 days to process your registration. You will receive a key either by Fidonet direct netmail, or by a personal letter via the U.S. Post Office. 43 Labtest 3.2 User's Guide Labtest Registration Form Date: _________ Yes! I want to register my copy of Labtest 3.2! Enclosed is a check or money order for the US $15.00 registration fee. YOU MUST USE THIS FORM TO ORDER VERSION 3.2. Fill out this form and mail to: Mark Williamson PO Box 133 Imperial Beach, CA 91932-0133 Please process my order according to the following: Your Name: ____________________________________________ BBS Name: ____________________________________________ BBS Software: ____________________________________________ Voice Phone: _____________________ BBS Phone: ______________________ Fidonet Address: __________________________________________ Mailing Address: ___________________________________________ ___________________________________________ ___________________________________________ Type Of Computer: __________________________________________ Operating System: __________________________________________ Comment/Suggestions : ______________________________________ ________________________________________________________ You should consider your copy of Labtest outdated if the LABTEST.EXE file is more than six months old. Due to constant changes, outdated versions cannot be supported. You are encouraged to keep your copy current by downloading the most recent version from one of the support sites. 44 Labtest 3.2 User's Guide 14 Contacting the author Mark Williamson lives in Imperial Beach, California. The most effective way to contact me is by calling one of the support BBS's listed in the beginning of this documentation or you may call the author's BBS at 619-575-4245. Leave a message with your comments/problems and your phone number. I will return your call as soon as possible. The Fidonet Node number for netmail and file requests is 1:202/750. File requests are available 23 hours a day. Zone Mail Hour is 1:00am to 2:00am PST. You may write to him via US mail by using the address in the REGISTER.DOC file. The latest version of Labtest can always be found on the author's system or any of the support sites listed in the beginning of this documenation. The magic name for file requests is LABTEST. 45