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
|
109KB
|
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