home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
UPCHECK
/
EXZT223K.ZIP
/
EXZTEST.DOC
< prev
next >
Wrap
Text File
|
1991-08-10
|
54KB
|
1,072 lines
<= ExZTest =>
Version 2.0
Part of the EXpert series programs available at
The Executive Network Information System
(914) 667-4567
------------------------------------------
Copyright 1988-1991 by Andy Keeves
Welcome to ExZTest!
──────────────────────────────────────────────────────────────────────────────
ExZTest once once envisioned as a small program to help remove some of
the "extra" stuff from displays generated by PKZIP during new upload testing.
Of course, in those days, sophisticated BAT files were needed and the
PCBTEST.BAT file was brand new for PCBoard systems.
ExZTest simmplifies the testing of newly uploaded files to a BBS and
takes care of most of the associated chores based on a configuration file. If
you have used previous versions of this program MAKE SURE you read through
these notes as LOTS of things have changed!
In short, ExZTest has the ability to test newly uploaded files for
integrity (if they have been compressed with PKZIP or PKARC), check for
possible virus infections through the use of external programs of your choice,
check for possible file duplication regardless of name, remove unwanted files
and many other like fuctions.
ExZTest is geared toward PCBoard BBS systems although it is possible
to use it with any BBS which allows a shell after a new upload.
If you have used ExZTest before.. READ THIS!
──────────────────────────────────────────────────────────────────────────────
ExZTest version 2.0 introduces a full-featured setup program and a
totally new configuration file format! The command line options used by older
versions is NOT COMPATIBLE WITH 2.x VERSIONS! Do not attempt to an old
PCBTEST.BAT file with this program without configuring first!! At the least,
the results shall be undesirable!
The ExZTest 2.0 configuration file was designed with upward
compatibility in mind. ExZip and ExZSetup will automatically recognize file
formats starting with this version and handle any required upgrading for you.
You can share a single configuration file between ExZip and ExZTest if
so desired. After all, most of the parameters are the same or similar.
Distribution and License!! Please read this!
──────────────────────────────────────────────────────────────────────────────
ExZTest is published as AdWare! What? You do not know what AdWare is?
Under the AdWare concept you are free to use it and distribute it as long as
you meet the following conditions:
a) You do not charge for it. No fees of any sort are
authorized to be asked for, accepted or collected!
b) Any and all alterations to the program or
documentation are expressly prohibited! You may,
however, post the program on your system in the format
you prefer (i.e. .ZIP or .ARC or whatnot).
c) You may not add any files to the ZIP file or other
compressed distribution file you may be using,
including your own bbs ad, and similarly, you may not
remove any file from the content, including my bbs ad,
which is part of the required registration!
d) i. If you operate a BBS and decide to use ExZip for
your BBS, under the concept of AdWare you are
required to post the enclosed BBS ad for the
Executive Network at least once in a message base
designated for BBS ads (if you have one) or on
your Main Board for a minimum of 7 days.
ii. If you do not operate a BBS, under the concept of
AdWare you are required to post the enclosed BBS
ad for the Executive Network on three (3)
bulletin board systems, other than the Executive
Network, of course, in the main message area or
an area specifically designated for that purpose
by the operator. DO NOT post our ad on systems
which prohibit the posting of BBS ads!
I must also add here that there are no warranties of any sort,
expressed or implied, that accompany this program. Use at your own risk.
Sorry. If you feel that the above points are not agreeable to you,
simply delete the file from your system. Pretty easy, don't you think?
Should you feel that you absolutely must pay for ExZTest, send a few $$ to
your favorite BBS Sysop - believe me, all Sysops can use it, since running
a board is NOT cheap! Please remember that I will try to fix problems as
reported, but I will do so at my convenience as time is available. This
program is made available to you at no real cost or investment which should
be considered when requesting "support".
Features summary.
──────────────────────────────────────────────────────────────────────────────
ExZTest is controlled through a configuration file. The supplied
ExZSetup program MUST be used for setting it up! DO NOT try to edit the
configuration file with a text editor! It will NOT work!
General features:
o Interfaces with STRIPZIP to remove file attributes;
o Handles primary and secondary ZIPs, ARCs, PAKs as
well as self-extracting ZIPs;
o Abbreviated activity and error logs;
o Checking for viruses and associated file disposition;
o Optional use of up to 5 different virus checking
programs;
o Optional use of duplicate checking and related disposition;
o Full featured setup program;
o Fully networkable operation;
o Unwanted file removal from ZIPs (TCAN);
o Automatic removal of ZIP comments;
o Alternate ZIP and ARC programs;
o Your choice of ZIP options for compression;
o Read Only and Hidden file handling;
o Adding a standard ZIP comment;
o Full self-check and anti-virus protection;
o File Id stamping to recognize files already processed,
even if they would normally qualify for ExZip's use;
o Creates PCBoard compatible pass/fail result files;
o Uses standard PCBoard 14.5 color codes;
o Optionally word-wraps file description;
o Optionally adds latest date in archive to description;
o Damaged file disposition options and matching notation
for PCBoard sysops;
o Enhanced file creation/write routines written in
assembler for added speed;
o Full error checking and handling, including full
network compatibility;
o Full duplicate checking through third third party programs;
New in version 2.1:
o Recognizes subdirectories stored in archives and will
"fail" files which contain them, holding them for review
by sysop.
o Additional DOS errorlevels are now supported:
Errorlevel 3 - if target file is a GIF
Errorlevel 4 - if target file is uknown
The use of external programs
──────────────────────────────────────────────────────────────────────────────
ExZTest now incorporates the use of some programs written by
other authors. One of these programs is STRIPZIP, written by
Ken Brown, made available to everyone free, as POSTWare. If you
use it, DO send him a postcard to THANK him for a terrific job!
StripZip should be available on most BBSs.
The second of these is VIRUSCAN from McAfee Associates.
Please note that ViruScan is NOT a free program! As with all ShareWare,
please register it if you are going to use it! This program can be
found on most BBSs listed as SCANxxxx.ZIP, including the Executive
Network, of course. Although we have received permission from McAfee
Associates to include SCAN with the ExZTest distribution file, we elected
not to do so (with the exception of one release) due to the frequency
of upgrades for this product.
For duplicate checking introduced in version 2.0 ExZTest interfaces
with either FWKCS from Fred W Kantor or ZDCS from Michael Cocke. Please
note that both of these programs are Shareware as well and if you elect to
use them you really SHOULD register them. The money you will send for them
will be more than saved in disk space recovered!
┌────┐
│┌───┴───────┐
└┤┌──────────┴───────┐
└┤┌─────────────────┴───┐
└┤┌────────────────────┴────┐
└┤ Self-test in progress.. │
└─────────────────────────┘
Although ExZTest incorporates only a small amount of code for
self-testing, it is quite capable to detect an attempted virus attack on
itself. Should this occur, the code will immediately lock up the machine it
is running on in order to prevent any further spreading of the possible virus.
Please remember that ExZip does not look for nor does it detect a virus
anywhere unless the virus attacks ExZip itself!
Getting started and setting up
──────────────────────────────────────────────────────────────────────────────
ExzSetup will do most of the work for you initially. Remember that
this manual is not intended to teach about the use of PCBoard or other
programs with which ExZTest might interface. You must have a working knowledge
of these before you get started here!
ExZSetup can be executed by simply typing "EXZSETUP" at the DOS prompt
or by specifying the drive, path and name of the configuration file you wish
to create or edit. For the rest of this document we will assume that you are
using the name EXZTEST.CFG which will be located in the current path. Once
you typed EXZSETUP you will get a small selection menu as follows:
┌─────────────────────────────┐
│ ExZip run time parameters │
│ ExZTest run time parameters │
│ ─────────────────────────── │
│ Define external text editor │
│ ─────────────────────────── │
│ Quit ExZSetup │
└─────────────────────────────┘
Press the DownArrow followed by ENTER to create/edit the EXZTEST.CFG
configuration file. The bottom line of your screen will be a status line
with brief instructions for you:
04:54:45 pm │ Esc: Exit/Backup │ Space: Toggle │ Cursor keys: Move │ CAP
The right side of the line will reflect the status of your Caps Lock and Num
Lock keys while the left side will reflect the then current system time. The
middle portion will indicate the usage of various control keys. If your
configuration file does not exist you will be asked if you want to create it:
┌[ File access error ]─────────────────────────────────────────────┐
│ Problem: File not found or invalid! │
│ Target : EXZTEST.CFG │
│ Action : Create new file now (Y/N)? _ │
└──────────────────────────────────────────────────────────────────┘
Press "Y" to confirm and proceed. You are now displayed the main options menu
which are applicable to the operation of EXZTEST.
┌─────────────────────────────┐
│ ExZip run time parameters │
│ ExZTest run time parameters │
│ ────────╒══════════════════════════════════╕
│ Define e│ Virus checking │
│ ────────│ Duplicate checking │
│ Quit ExZ│ File attribute handling │
└─────────│ ──────────────────────────────── │
│ Disposition of damaged files │
│ Disposition of virus infections │
│ ──────────────────────────────── │
│ ZIP comment insertion │
│ Compression programs │
│ Compression formats to process │
│ Run time options (switches) │
│ Activity log file │
│ ──────────────────────────────── │
│ Supporting files (text) │
│ Supporting files (processing) │
╘══════════════════════════════════╛
You can move around the menu with your up and down arrow keys, page up and
page down and you may leave the menu by pressing the escape key. Once you have
positioned yourself to the item you wish to edit simply press the ENTER key to
proceed. Most menus and options that follow will require the use of the
cursor control keys though a few will also require typing. We will take each
selection as they appear on the menu above (this is not my favorite part when
it comes to releases!).
Checkin for virus infection
──────────────────────────────────────────────────────────────────────────────
You can have ExZTest use up to 5 different programs to check for virus
infections. They must all have the ability to take all required parameters
from the DOS command line and operate on all files in a specified path (passed
to them by ExZTest). ExZSetup will give you the default command line for
McAffe's Viruscan program. Use the "!" character where the location of files
to be checked should go:
┌─────────────────────────────┐
│ ExZip run time parameters │
│ ExZTest run time parameters │
│ ────────╒══════════════════════════════════╕
│ Define e│ Virus checking │
│ ────────│ Du┌[ Virus detection ]───────────────────────────────────────┐
│ Quit ExZ│ Fi│ │
└─────────│ ──│ Virus checking: ON │
│ Di│ Program 1: SCAN ! /NOMEM /A /X /EXT Z:NUV │
│ Di│ Program 2: │
│ ──│ Program 3: │
│ ZI│ Program 4: │
│ Co│ Program 5: │
│ Co│ ┌─────────────────────────────────┐ │
│ Ru└─────────────────│ Space or Enter to toggle │──────┘
│ Activity log file │ Arrow keys to change lines │
│ ────────────────────│ ESC to exit │
│ Supporting files (te└─────────────────────────────────┘
│ Supporting files (processing) │
╘══════════════════════════════════╛
Checking for and eliminating duplicates
──────────────────────────────────────────────────────────────────────────────
This one becomes more complex! ExZTest relies on either FWKCS or ZDCS
to establish file duplications. You need to have setup the database required
by one of them in order to use the duplicate checking options of ExZTest.
Please consult the documentation for your choice of programs BEFORE deciding
here. Both authors are available through the ILink mail network.
NOTE!! If you decide to use FWKCS as the duplicate checking engine
for ExZTest you need to know that ExZTest has been tested ONLY
with versions 1.06 through 1.09. Due to the release methods
chosen by the author later versions are not supported by this
program!
NOTE!! If you decide to use ZDCS as the duplicate checking engine
for ExZTest you need to know that ExZTest will work ONLY with
the 1.6 or later releases of this software!! Earlier versions
did not offer the hooks used by ExZTest!
If you toggle duplicate checking ON you will have to define a few
other choices for ExZTest, as well the choice of duplicate checkers you wish
to use! Before setting up and testing ExZTest for duplicate detection you
should have set up your selected database with one of the two above mentioned
programs! In order to give you a better understanding of these we need to
define what the definitions shown below mean.
A "full, 100% duplicate" is a .ZIP file the contents of which already
exists on your system. The content may be in another single .ZIP or spread
over several .ZIPs - we simply do not care. If every file is already present
somewhere we will consider it a FULL duplicate. You may dispose of these
files by deleting them or renaming them. If you elect to rename ExZTest will
change the file's extention to .DUP for you. You may toggle this choice by
pressing the space bar once highlighted.
If you selected ZDCS your screen will look something like:
┌─────────────────────────────┐
│ ExZip run time parameters │
│ ExZTest run time parameters │
│ ────────╒══════════════════════════════════╕
│ Define e│ Virus checking │
│ ────────│ Dup┌[ Duplicate checking ]───────────────────────────────┐
│ Quit ExZ│ Fil│ │
└─────────│ ───│ Duplicate checking : ON │
│ Dis│ Software in use (FWKCS/ZDCS) : ZDCS │
│ Dis│ │
│ ───│ Disposition of full (100%) duplicates: D (Delete) │
│ ZIP│ Disposition of partial duplicates : A (Auto!) │
│ Com│ Minimum percentage to pass partial : 18% │
│ Com│ │
│ Run│ │
│ Act│ │
│ ───│ ┌─────────────────────────────────┐
│ Sup│ │ Space or Enter to toggle │
│ Sup│ │ Arrow keys to change lines │
╘════└──────────────────────────│ ESC to exit │
└─────────────────────────────────┘
If you selected FWKCS your screen will look something like:
┌─────────────────────────────┐
│ ExZip run time parameters │
│ ExZTest run time parameters │
│ ────────╒══════════════════════════════════╕
│ Define e│ Virus checking │
│ ────────│ Dup┌[ Duplicate checking ]───────────────────────────────┐
│ Quit ExZ│ Fil│ │
└─────────│ ───│ Duplicate checking : ON │
│ Dis│ Software in use (FWKCS/ZDCS) : FWKCS │
│ Dis│ │
│ ───│ Disposition of full (100%) duplicates: D (Delete) │
│ ZIP│ Disposition of partial duplicates : A (Auto!) │
│ Com│ Minimum percentage to pass partial : 18% │
│ Com│ Sort program : QSORT │
│ Run│ CSList1.SRT location & name : │
│ Act│ J:\CS\CSLIST1.SRT │
│ ───│ CSList1.NDX location & ┌─────────────────────────────────┐
│ Sup│ J:\CS\CSLIST1.│ Space or Enter to toggle │
│ Sup│ │ Arrow keys to change lines │
╘════└──────────────────────────│ ESC to exit │
└─────────────────────────────────┘
You have 3 possible choices for a partial duplicate. A partially
duplicated .ZIP file is one where at least one of the files within the .ZIP
does not yet exist on your system. Once again, you can toggle the choices for
partial duplicate disposition by pressing the space bar once the selection is
highlighted. ExZip will not delete a partial duplication for you. The most
common partial duplication is a newer version of a file where some of the
documentation has not changed. You can rename the file and decide later or
you can "pass" the file as is, making it available to your callers. The 3rd
choice is an automatic decision to be made by ExZTest. This is based on the
percentage of duplication. You may specify percentages on the next line
starting with 10%. The value you specify here is the percentage
of files which are NEW to your system! Each new upload must
contain at least this percentage of new files, which do not
already exist on your system! In other words, if you were to specify 60%
a .ZIP file containing 10 files inside would "pass" if 4 or less of the 10
files were duplicates and "fail" if 5 or more were duplicated.
NOTE that when using ZDCS this percentage specification need not be
the same as the one entered in your ZDCS configuration file! The two can and
do operate quite well and independent of each other! You should
also not that the usage of percentages by ZDCS is quite different
from the above, but the translation is done by the programs and
transparent to you!
For the sort program required by FWKCS we default to the widely
available QSORT although many others may be used. The only requirement for
the sort program is that it must be able to sort a file "in place". We pass
only one paramater to the sort routine, that being the file name. When sort
terminates we expect to find the same file in the same place, sorted.
The CSLIST1.SRT and CSLIST1.NDX files are the generic names for 2 of
the 4 files used/created by FWKCS. You must enter the proper drive, path and
file name here. If ExZSetup does not find the specified file the name you
entered will be flashing in red.
Handling file attributes in ZIPs
──────────────────────────────────────────────────────────────────────────────
ZIP files have the ability to retain file attributes, such as Read
Only which can do nasty things to your system. We aim to remove these before
doing anything with the file. A program widely available on BBSs called
STRIPZIP is the one we default to since it handles the task rather well.
ExZTest will insert the name of the file being processed whereever you type a
pound sign (#) which makes this option reasonably flexible. DO NOT overlook
or underestimate the power of this option! Too many Sysops have been burned
by files extracted from a ZIP which could not be deleted and were added to
other ZIPs later in the processing cycle!!
┌─────────────────────────────┐
│ ExZip run time parameters │
│ ExZTest run time parameters │
│ ────────╒══════════════════════════════════╕
│ Define e│ Virus checking │
│ ────────│ Duplicate checking │
│ Quit ExZ│ File attribute handling │
└─────────│ ──────────────────────────────── │
│ Dispositi┌[ Attribute handling ]─────┐
│ Dispositi│ │
│ ─────────│ STRIPZIP /R # │
│ ZIP comme│ ┌────────────────────────────────────┐
│ Compressi└──────────│ Enter a single pound sign (#) │
│ Compression formats │ where the .ZIP file name should be │
│ Run time options (sw│ This is a full DOS command line │
│ Activity log file └────────────────────────────────────┘
│ ──────────────────────────────── │
│ Supporting files (text) │
│ Supporting files (processing) │
╘══════════════════════════════════╛
Disposition of damaged or virus infected files
──────────────────────────────────────────────────────────────────────────────
Both of these options are defined the very same way. The pop-up
screen offers you 4 choices through which you can move up and down with your
arrow keys. Once you highlighted the option you desire to use press ENTER or
ESC to activate it. Hopefully, the following illustration will be
self-explanatory to most reading this..
┌─────────────────────────────┐
│ ExZip run time parameters │
│ ExZTest run time parameters │
│ ────────╒══════════════════════════════════╕
│ Quit ExZ│ Virus checking │
└─────────│ Duplicate checking │
│ File attr╔══════════════════════════════════════╗
│ ─────────║ Disposition of damaged files: ║
│ Dispositi╚════════════════════┌─────────────────────────────┐
│ Disposition of virus infection│ Keep target file │
│ ──────────────────────────────│ Delete target file │
│ ZIP comment insertion │ Overwrite with 0 byte file │
│ Compression programs │ Rename and keep file │
│ Process files in .ARC format └─────────────────────────────┘
│ Use ANSI colors in DOS │
│ Activity log file │
│ ──────────────────────────────── │
│ Paths to process │
│ Supporting files │
│ Index file specifications │
╘══════════════════════════════════╛
ZIP file comments
──────────────────────────────────────────────────────────────────────────────
While we are very much against BBS ADS being inserted into ZIPs as
files we have no real problems with comments being added to the ZIP file.
Comments are easily removed by anyone (STRIPZIP mentioned above will
automatically remove them for you!). If you wish to add a ZIP comment of your
own to files processed by ExZTest you need to create a text file containing the
comment to add. Once you have done this you simply turn on the option in
ExZSetup and specify the exact location and file name which contains the text.
┌─────────────────────────────┐
│ ExZip run time parameters │
│ ExZTest run time parameters │
│ ────────╒══════════════════════════════════╕
│ Quit ExZ│ Virus checking │
└─────────│ Duplicate checking │
│ File attribute handling │
│ ──────────────────────────────── │
│ Disposition of damaged files │
│ Disposition of virus infections │
│ ──────────────────────────────── │
┌[ Zip comment insertion ]─────────────────────────────────────┐
│ │
│ In use : NO │
│ Filename: │
│ │
└──────────────────────────────────────────────────────────────┘
│ Paths to process │
│ Supporting files │
│ Index file specifications │
╘══════════════════════════════════╛
Compression programs
──────────────────────────────────────────────────────────────────────────────
Although ExZTest's primary task is to handle ZIP files it does have
the ability to check .ARC files for you. It will automatically detect the
file type based on the extension but it will not verify it otherwise.
┌─────────────────────────────┐
│ ExZip run time parameters │
│ ExZTest run time parameters │
│ ────────╒══════════════════════════════════╕
│ Define e│ Virus checking │
│ ────────│ Duplicate checking │
│ Quit ExZ│ File attr╔══════════════════════════════════════╗
└─────────│ ─────────║ Compressed file type to process: ║
│ Dispositi╚════════════════════┌─────────────────────────────┐
│ Disposition of virus infection│ This program automatically │
│ ──────────────────────────────│ recognizes & handles files │
│ ZIP comment insertion │ in ZIP, ARC & PAK formats! │
│ Compression programs └─────────────────────────────┘
│ Compression formats to process │
│ Run time options (switches) │
│ Activity log file │
│ ──────────────────────────────── │
│ Supporting files (text) │
│ Supporting files (processing) │
╘══════════════════════════════════╛
Run time options and switches
──────────────────────────────────────────────────────────────────────────────
Yes, this is the part you have been looking for! So now that you are
here, pay attention! Let's take them one by one:
┌─────────────────────────────┐
│ ExZip run time parameters │
│ ExZTest run time parameters │
│ ────────╒══════════════════════════════════╕
│ Define e│ Virus checking │
│ ────────│ Duplicate checking │
│ Quit ExZ│ File attri┌[ Run time options ]─────────────────────────┐
└─────────│ ──────────│ │
│ Dispositio│ ReZip secondary ZIPs (Zip in Zip) : Yes │
│ Dispositio│ Use PCBoard's color codes : Yes │
│ ──────────│ Acceptable age of files (0-999 days) : 275 │
│ ZIP commen│ Fail or Warn if old file is detected : Fail │
│ Compressio│ Beeps & bells : Yes │
│ Compressio│ Word wrap file descriptions : Yes │
│ Run time o│ Add last revision date to description: Yes │
│ Activity l│ │
│ ──────────└───────────────────┌─────────────────────────────────┐
│ Supporting files (text) │ Space or Enter to toggle │
│ Supporting files (processing) │ Arrow keys to change lines │
╘═══════════════════════════════│ ESC to exit │
└─────────────────────────────────┘
- ReZIP switch: this does NOT mean that all files will automatically be
re-ZIPped for you! However, since ExZTest does most of the work during a
shelled process it has no immmediate knowledge of things done, such as
possible files which have been removed from the secondary ZIPs. This
switch simply tells ExZTest to reeZIP the file IF items have been removed
from the primary ZIP or if secondary ZIPs were processed. This will also
slow the process a great deal! BUT.. without this option you cannot
remove files from secondary ZIPs.. :)
- Use PCBoard's color codes simply adds the "@X" codes to the result files
when turned on.
- Age of files is measured in days and can range up to 999 days. Placing a
ZERO here will disable age checking. Placing a number other than ZERO will
tell ExZTest to check for the most recent file in the ZIP being no older
than the number of days you specify. If all files are older than specified
here, the next item comes into play.
- When a file is found "too old" for your system ExZTest can either warn the
user and allow the offending file anyway or it can fail the file and tell
the uploader why. Your choice which..
- Beeps and bells are sounds made by ExZTest when a file passes or fails.
- Word wrap.. This one depends exclusively on the interface between your
PCBoard 14.5 system and ExZTest. IF a caller is on-line, ExZTest will
fetch information from PCBoard, including the file description given by the
uploader and attempt to re-wrap it within PCBoard guide lines for you.
- The last revision date switch has three toggle positions. If not running a
PCBoard 14.5 system you need to turn this OFF. If you are, ExZTest can
pick out the most recent date within the new file and add it to your file
description for you, on the fly! You may select this information to be
added with full word wrap (see previous switch) or to a seperate line by
itself.
Telling you about the results
──────────────────────────────────────────────────────────────────────────────
ExZTest will keep a running log of what it has found for you. This is
a small feature which will see significant expansion in the future but we
lected to get version 2 out (finally) so for now this remains rather skimpy.
┌─────────────────────────────┐
│ ExZip run time parameters │
│ ExZTest run time parameters │
│ ────────╒══════════════════════════════════╕
│ Define e│ Virus checking │
│ ────────│ Duplicate checking │
│ Quit ExZ│ File attribute handling │
└─────────│ ──────────────────────────────── │
│ Disposition of damaged files │
│ Disposition of virus infections │
│ ──────────────────────────────── │
┌[ Activity log file ]───────────────────────────────────────┐
│ │
│ Log file to use: │
│ J:\PCB\EXZTEST.LOG │
│ │
└────────────────────────────────────────────────────────────┘
│ Supporting files (text) │
│ Supporting files (processing) │
╘══════════════════════════════════╛
Defining your ExZTest supporting files - Part 1
──────────────────────────────────────────────────────────────────────────────
There are TWO sets of supporting files used by ExZTest! The first
group consists of 4 files used for messages and information displayed to your
caller. These files will be looked for in your current directory when ExZTest
is running. If not found, your DOS search path will be checked, path by path,
AS LONG AS YOU DO NOT specify a path during your setup! Please note that when
running on a PCBoard system the file extension is important! You can create
ALL of these files in various language versions with the proper extensions!
The first of these files, EXZTEXT, contains the standard text lines
used by the program. This is NOT an ASCII text file! Do not use a text
editor to modify it! Use ExZSetup's internal editor ONLY! This is the only
REQUIRED file of the four!!
You may, room permitting, use any PCBoard color code, display variable
and control character in these files, including nested file specifications!
┌─────────────────────────────┐
│ ExZip run time parameters │
│ ExZTest run time parameters │
│ ────────╒══════════════════════════════════╕
│ Define e│ Virus checking │
│ ────────│ Duplicate checking │
│ Quit ExZ│ File attribute handling │
└─────────│ ──────────────────────────────── │
┌[ Supporting file specification ]─────────────────────────────────────┐
│ │
│ Files containing display text for errors & prompts: │
│ ExZTest standard text : EXZTEXT │
│ Text if file is too old : EXZDATE │
│ Text if full duplicate : EXZFDUP │
│ Text if part duplicate : EXZPDUP │
│ │
└────────────────────────────── F2=Edit ───────────────────────────────┘
│ Supporting files (text) │
│ Supporting files (processing) │
╘══════════════════════════════════╛
The files EXZDATE, EXZFDUP and EXZPDUP should contain text you wish to
display to your caller if the file is either too old for your system, is a
full, 100% duplication or a partial duplication respectively. These are
standard ASCII text files and may be created/edited with any text editor. You
can use ExZSetup's primary menu to define the name of this text editor if you
wish to use F2 interactively for them.
If any of these 3 files is not found ExZTest will use the proper text
from the EXZTEXT file t explain the problem. If the needed file exists,
ExZTest will append the file, in entirety, to the generated result file.
┌─────────────────────────────┐
│ ExZip run time parameters │
│ ExZTest run time parameters │
│ ─────────────────────────── │
│ Define external text editor │
│ ─────────────────────────── │
│ Quit ExZSetup │
└─────────────────────────────┘
┌[ Text Editor ]────────────┐
│ │
│ QEdit # │
│ ┌────────────────────────────────────┐
└──────────│ Enter a single pound sign (#) │
│ where the file name should be. │
│ This is a full DOS command line │
└────────────────────────────────────┘
When you select EXZTEXT and press F2 you will proceed to the internal
editor where you will always see the intended text along with the text you may
have changed to.
┌─────────────────────────────┐
│ ExZip run time parameters │
│ ExZTest run time parameters │
│ ────────╒══════════════════════════════════╕
│ Define e│ Virus checking │
│ ────────│ Duplicate checking │
│ Quit ExZ│ File attribute handling │
└─────────│ ──────────────────────────────── │
┌[ Supporting file specification ]─────────────────────────────────────┐
│ │
┌─[ EXZTEXT ]────────────────────────────────────────────────────────── 1 ┐
│ │
│ Default: │
│ Unrecognized error occured. │
├──────────────────────────────────────────────────────────────────────────┤
│ │
│ Actual: │
│ Unrecognized error occured. │
└──────────────────────────────────────────────────────────────────────────┘
╘══════════════════════════════════╛
NOTE!! YOU MUST CREATE THIS FILE BEFORE USING EXZTEST!!
Defining your ExZTest supporting files - Part 2
──────────────────────────────────────────────────────────────────────────────
There are three additional supporting files, used for processing,
which you may elect to use with ExZTest. Each of them are handled in the same
fashion but they each have different uses. In all cases you may use the
question mark as a wild card character, however, you may NOT use an asterisc!
┌─────────────────────────────┐
│ ExZip run time parameters │
│ ExZTest run time parameters │
│ ────────╒══════════════════════════════════╕
│ Define e│ Virus checking │
│ ────────│ Duplicate checking │
│ Quit ExZ│ File attribute handling │
└─────────│ ──────────────────────────────── │
┌[ Supporting files ]────────────────────────────────────────┐
│ │
│ Unwanted files' list: │
│ J:\PCB\NODE8\EXZIP.EXC │
│ Acceptable duplications' list: │
│ J:\PCB\NODE8\EXZIP.VDL │
│ 'Do Not Process' file list: │
│ J:\PCB\NODE8\EXZIP.DNP │
│ │
└────────────────────────[ F2=Edit ]─────────────────────────┘
│ Supporting files (processing) │
╘══════════════════════════════════╛
The "unwanted" file listing contains names which you wish to delete
from a ZIP file at all times. Typically, you might add things such as
COMMAND.COM or PKUNZIP.EXE (how could you extract PKUNZIP from a ZIP if you
didn't already have it?).
The "acceptable duplication" listing contains file names which you do
not want to check against other files on your system. A typical example of
these might be things like certain VGA drivers which show up in numerous ZIP
files.
The "do not process" listing tells ExZTest to completely bypass a file
listed here. This is useful mostly for ExZip.
To define either of these files you need to specify their actual
location, including drive and path, along with the name of the file to use. If
the file does not exist the name will flash in red.
To create or edit these files highlight the one you wish to work on
and press F2.
┌─────────────────────────────┐
│ ExZip run time parameters │ ┌[ Pick list ]────────────────┐
│ ExZTest run time parameters │ │ WELCOME.TXT READ_ME.PLS │
│ ────────╒════════════════════════════════│ VIRUSCHK.DOC READ_ME.750 │
│ Define e│ Virus checking │ U_README READ_1ST.PLS │
│ ────────│ Duplicate checking │ U_READ.ME READ_1ST.EXE │
│ Quit ExZ│ File attribute handling │ U_CAN.REG READTHIS.TOO │
└─────────│ ───────────────────────────────│ UREAD1ST READNOW.TFB │
┌[ Supporting files ]─────────────│ UGLY.COM README2.COM │
│ │ U-CAN.REG README1.DOC │
│ Unwanted files' list: │ TYPE.ME README.TFB │
│ J:\PCB\NODE8\EXZIP.EXC │ TPB README.ROS │
│ Acceptable duplications' list: │ SOUND.MSG README.CUE │
│ J:\PCB\NODE8\EXZIP.VDL │ SAVEADS.ZIP README.?? │
│ 'Do Not Process' file list: │ SAFE_OWL.COM README.33 │
│ J:\PCB\NODE8\EXZIP.DNP │ RUN-ME.COM README-9.??? │
│ │ ROSEREAD.ME README-8.??? │
└────────────────────────[ F2=Edit│ ROCKLAND.BBS README-7.??? │
│ Supporting files (processing) │ READ_ME.TXT README-6.??? │
╘════════════════════════════════├─────────────────────────────┤
│ Scratch pad : WELCOME.TXT │
└─────────────────────────────┘
The 'pick list' displayed may contain no files or more files than will
fit in the display window (depending on your file). You can move around this
list with your arrow keys easily. To change an existing entry simply
highlight it and press the ENTER key. The name will move down to the "scratch
pad" for editing. To add a new name to the list press INS. This will make
"room" for a new item. To remove a name from the list highlight the item to
be removed and press DEL. Remember that the list of names will always be
resorted for you on exit.
Finishing it all up..
──────────────────────────────────────────────────────────────────────────────
If you entered correct information and selected the proper options you
wish to use you are now ready for a test run of ExZTest!
┌─────────────────────────────┐
│ ExZip run time parameters │
│ ExZTest run time parameters │
│ ────────╒══════════════════════════════════╕
│ Quit ExZ│ Virus checking │
└─────────│ Duplicate checking │
│ File attribute handling │
│ ──────────────────────────────── │
│ Disposition of damaged files │
│ Disposition of virus infections │
│ ──────────────────────────────── │
│ ZIP comment insertion │
│ Compression programs │
│ Process files in .ARC format │
│ Use ANSI ┌──────────────────────────────────────┐
│ Activity │ Save changed information (if any)? _ │
│ ─────────└──────────────────────────────────────┘
│ Paths to process │
│ Supporting files │
│ Index file specifications │
╘══════════════════════════════════╛
Press ESC one more time to leave the setup program:
So long from ExZSetup v2.1 and remember...
Smoking is one of the leading causes of statistics.
Command line options
──────────────────────────────────────────────────────────────────────────────
There are relatively few command line options available in ExZTest.
All are identified by a leading / (slash) as the first character of the option.
Options are not case sensitive, may be specified in any order and leading and
trailing spaces are ignored. All of them may be abbreviated down to 2
characters (except specified values where applicable).
The ExZTest command line is:
EXZTEST <filespec> <mode> </option1> </option2> ... </option?>
To use this in your PCBTEST.BAT file you need to replace filespec with %1 and
mode with %2. PCBoard will do the rest for you! Thus, your batch file will
likely look as complicated as this one here:
@Echo off
Exztest %1 %2
Whew! Glad that one is behind us! :) To use ExZTest manually for testing
individual files you need to know what those optional items are.
<filespec> is the full drive, path and name (including extension) of
the file you wish to test.
<mode> must be the keyword "UPLOAD" or "TEST" without the quotes.
When using the keyword UPLOAD, ExZTest will perform all
functions you specified in your configuration file. When
using the keyword TEST it will do only limited tests, those
which will NOT alter the file, in order to establish file
integrity.
All options MUST follow the two above parameters. None of them need
to be present. All command line options may be abbreviated to the first two
letters following the slash (and must be at least that long). The available
options and their uses are:
/C= Optional configuration file specification. If this is
present, it will override the program's default name of
EXZTEST.CFG. If the file name is not preceeded by a drive
and/or path specification ExZTest will search all paths
specified in your DOS PATH= setting in order to locate the
file. The equal sign IS REQUIRED.
/T= Optional work drive letter. ExZTest defaults to using the
current drive for work areas. This can be slow on a network
system and if sufficient memory is available you can direct
ExZTest to use a RAM drive or another network drive perhaps.
Bear in mind that when testing a large file ExZTest WILL NEED
space! More space than the file requires if re-Zipping! If
you are pointing ExZTest to a RAM drive it MAY run out of
space which is a condition it cannot help! But, it will
handle all work paths in a network compatible manner.
/KE If you wish to see what ExZTest is doing you can use this
parameter to have it leave the work BAT files on-line for you.
This has no practical value beyond troubleshooting and
learning.
Other options, notes & thoughts
──────────────────────────────────────────────────────────────────────────────
EXZUTIL.COM - this is a small program which you can place in any of
your search paths. ExZTest cannot determine if a file
with the .EXE extention (contained within a ZIP) is a
self-extracting archive or not. It will look for the
presence of ExZUtil and if it finds it, it will use the
program to identify self-extracting ZIP files with the EXE
extension.
ZIPs in ZIPs - ExZTest will fully process a ZIP found within a ZIP (or for
that matter an ARC in a ZIP or ARC in an ARC). However,
it will NOT process down to the third level. Inasmuch as
I find ZIPs in ZIPs an acceptable practice I disagree with
going to 3 or more levels.
Problems - All known problems of previous release versions have been
corrected.
FWKCS/ZDCS - Duplicate checking depends a great deal on your ability to
initially set-up the software. Both packages are supplied
with full documentation and startup instructions. Please
use them!
ExZTest uses only individual file 'signatures' - not ZIP
signatures. As far as ExZTest is concerned you can remove
all ZIP file signatures.
Once you have 'cleaned up' your system and eliminated
duplications which already existed (if that is desired)
you can, if you want to also eliminate multiple occurances
of signatures. Again, ExZTest looks only for identical
matches. Please see individual program instructions for
the one you decide to use for more details.
FWKCS prior to version 1.06 consisted of two programs.
ExZTest will identify this and properly interface with
either. ExZTest will function correctly with either v1.05
1.08 or 1.09 of this software. It has not been tested with
versions above 1.09 thus it is entirely possible that they
will not interface correctly.
ZDCS versions prior to 1.6 willll NOT work! You need to
interface with the 1.6 or later release!!
Memory use - ExZTest uses a moderate amount of RAM which is allocated
dynamically as needed. Since the supporting files, such
as ExZTest.EXC are loaded in entirety the amount of memory
required will vary from site to site. You must remember,
however, that ExZTest will shell and load programs such as
PKZIP which require a fair amount of RAM by themselves (I
have seen PKZIP use as much as 300+ KB) thus the more
memory you can give it the safer you'll be. I cannot
check for memory while in a DOS shell! ExZTest will
insist that you use the PCBoard "/SWAP" parameter when low
memory is detected at startup!
Disk use - ExZTest unzips files it processes one at a time, thus the
space required for work areas will not be greater than the
contents of the largest ZIP it is to process.
The end (yes! really!)
──────────────────────────────────────────────────────────────────────────────
I really do not have much more to add although I am quite certain I
have overlooked a number of points which perhaps should have been mentioned. I
never claimed to be good at writing documentation. :) If ExZTest works for you
and helps that is great. If I wasted your time reading all this and it really
isn't for you, so be it.
Please note that any trade marks and service marks mentioned in this
document belong to someone. I do not hold any trademarks on anything
associated with this software. I do, however, reserve all rights and
copyright to ExZTest, ExZSetup and ExZip.
My greatful appreciation to many who have helped ExZTest get to where it
is today including but not limited to the beta testers who's files and
directories were at the mercy of early versions. Although all beta tester
feedback is valuable I need to specifically thank Mike Meyer and Ray Novino
for their time and dedication to this project and Mark Rapp for expanding on
some of the original ideas. Much of what we accomplished in ExZTest will be
the foundation of the next ExZTest program (and many notes are already in the
files)!
All typos (for which I am famous) found in this document are
intentional. (And if you beleive that you should send me $1,000 in small
bills for registration!)
All items which have been forgotten will eventually be removed from
the program to make it consistent with the documentation.
Since, in my opinion, no documentation should ever exceed 1000 lines
in length (and if so, it should certainly not be by much) we'll put an end to
this real soon. If you managed to read this far you should bear in mind that
you might be the only one! If you need to contact me I can be reached on the
ILink mail network's Sysop echo and Shareware echo.
Have fun!