TranScan (TM)
Version 4.00 - Jan 93
_______
____|__ | (R)
--| | |-------------------
| ____|__ | Association of
| | |_| Shareware
|__| o | Professionals
-----| | |---------------------
|___|___| MEMBER
TranScan BBS, 3760 SW Pk S Ct #102, Topeka, KS. 66609-2106
(voice) 913-266-2287 (BBS) 913-266-0781
(orders only) 1-800-578-3061
Copyright (c) 91, 92, 93 by Craig E. Dunstan
ALL RIGHTS RESERVED!
Revised: Jan 93
What is TranScan?
~~~~~~~~~~~~~~~~~
TranScan is a compressed file scanner and converter. It can take files
compressed in virtually any format, extract them, scan them for
viruses, then convert them to your favorite compression method. It can
process a single file or multiple files, single directory or multiple
directories, single drive or multiple drives. It can also process GIF and
JPG files, and TeleDisk files. It can test files for integrity,
viruses, age/date, and even GIF Resolution.
If you run a BBS you can use TranScan in your Post Upload batch file to
process each file as it is uploaded. TranScan can even display info
to the COM port so that the caller can watch the processing.
Association of Shareware Professionals Ombudsman
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
"TranScan is produced by a member of the Association of Shareware
Professionals (ASP). ASP wants to make sure that the shareware
principle works for you. If you are unable to resolve a
shareware-related problem with an ASP member by contacting the member
directly, ASP may be able to help. The ASP Ombudsman can help you
resolve a dispute or problem with an ASP member, but does not provide
technical support for members' products. Please write to the ASP
Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a CompuServe
message via CompuServe Mail to ASP Ombudsman 70007,3536."
C O N T E N T S
~~~~~~~~~~~~~~~~~
Legal Stuff
Registration
Installing TranScan
TranScan's Menu System
TranScan's Command Lines
TranScan's Errorlevels
TranScan's Environment Variables
TranScan's Built-In Editor
External Programs Needed
TranScan and Memory Usage
File_Id.Diz, Desc.Sdi, & GIF Descriptions
GIFFY v0.90a BETA
CRCTEST v0.90a BETA
TRANSCAN JR v4.00
What is Shareware?
ASP HUB Network
L E G A L S T U F F
~~~~~~~~~~~ ~~~~~~~~~~~
WARRANTY
--------
TRANSCAN IS SUPPLIED AS IS. THE AUTHOR DISCLAIMS ALL WARRANTIES,
EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THE WARRANTIES OF
MERCHANTABILITY AND OF FITNESS FOR ANY PURPOSE. THE AUTHOR ASSUMES NO
LIABILITY FOR DAMAGES, DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT FROM
THE USE OF TRANSCAN.
COPYRIGHT NOTICE & LICENSE
--------------------------
TranScan is distributed as SHAREWARE. Under this concept you may use
the SHAREWARE (UnRegistered) version for a reasonable period of time,
which I consider to be 30 days, after which you must register your copy
or discontinue usage all together. The Trail Version contains all
features described in the documents and is NOT CRIPPLED and will NOT
EXPIRE in any way.
ACKNOWLEDGEMENTS
----------------
o Special thanks to all the members of the TranScan Beta Team! Their
help in finding all the problems with TranScan v4.00 is appreciated!
o Thanks also to everyone who has already registered TranScan! Your
support of shareware has allowed |--(THIS NOUN PHRASE APPEARS INCOMPLETE. CHECK FOR WORD FORMATION AND PUNCTUATION ERRORS AND MISSING WORDS.)--| my to devote FULL TIME to TranScan!
o This program was written using Turbo Pascal v7.0 from Borland
International, Scotts Valley, CA.
o This program used routines Async Professional v1.10, Object
Professional v1.20 and B-Tree Filer v5.40 from TurboPower Software,
Scotts Valley, CA.
o Wildcat (TM), and QmodemPro (c) Mustang Software, Bakersfield, CA.
o ViruScan (c) 1989093 by McAfee & Associates.
o PkPak, PkUnPak, PkZip (TM), and PkUnzip (TM) 1986-1993 by Phillip
W. Katz, PKWARE Inc.
o LHa and LHarc (c) 1988-1989 by Haruyasu Yoshisaki.
o Pak (c) 1988-1989 by NoGate Consulting.
o Zoo (c) 1988 by Rahul Dhesi.
o Arj (c) 1990-1991 by Robert K. Jung.
o Hyper (c) 1986-1990 by Dean W. Cooper.
o GIFLite (c) 1991 by Tsung Hu.
o TeleDisk (c) 1990 by Sydex.
o GIF2JPG and JPG2GIF (c) 1990-1991.
o GIF is a trademark of CompuServe.
o DesqView (c) 1985-1993 by Quarterdeck Office Systems.
R E G I S T R A T I O N
~~~~~~~~~~~~~~~~~~~~~~~~~
Registration to TranScan includes:
* 90 day toll free technical support.
* Registered User access to TranScan BBS.
* Free upgrades for one year.
* Free subscription to TranScan Newsletter.
* Removal of registration reminder screen.
* Subscription discount to SHAREWARE MAGAZINE.
* FREE introductory membership to COMPUSERVE, plus
$15 of on-line credit.
* Several FREE BONUS utilities.
To register TranScan, fill out the registration form included on this
distribution disk (TS.REG) and send with a check or money order
(in US funds only) for the appropriate amount or complete the
MasterCard/Visa information. Mail to:
Craig E. Dunstan
TranScan BBS
3760 SW Pk S Ct #102
Topeka, KS. 66609-2106
You can also register using MasterCard or Visa by calling the BBS at
913-266-0781 or by calling voice, at 1-800-578-3061.
Upon receipt of the appropriate registration fee we will acknowledge
the registration by U.S. mail and:
* Provide the user with the codes necessary to remove the
registration reminder screen.
* Provide the user with the registration number entitling the
user to update and telephone support.
The registration fee is for the use of a single copy of TranScan by
ONE individual. TranScan may be used on any computer owned by the
registered user so long as there is NO possibility of TranScan being
used at more than one location at the same time. Please contact
Craig E. Dunstan for information on multiple copy registration and site
licenses.
SUPPORT
-------
Registered Users of TranScan are entitled to the following support:
* CompuServe - Technical questions and inquires can be E-Mailed
to: Craig E. Dunstan [70713,671]
* Mail support - You can send all questions and inquiries to
the following address:
Craig E. Dunstan
TranScan BBS
3760 SW Pk S Ct #102
Topeka, Ks. 66609-2106
* Echo Conference Support - You can address questions to
Craig Dunstan in any of the following conferences:
MSI Wildcat
Fido-Wildcat
Rime-Wildcat
* BBS Support - You can log onto the TranScan Support BBS by
calling 913-266-0781.
* Telephone Support - Registered users may call 913-266-2287
for technical support.
Non-Registered users of TranScan may call 913-266-2287 for
assistance to install a shareware copy of TranScan and
evaluate it during the 30 day evaluation period. We cannot
guarantee continued support to Non-Registered Users beyond
the 30 day evaluation period.
I N S T A L L I N G T R A N S C A N
~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~
To install TranScan place the following files in a directory that is in
your PATH: TS.EXE, TS.OVR, and TS.HLP.
To setup the program at your DOS prompt type the following:
TS
T R A N S C A N ' S M E N U S Y S T E M
~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~ ~~~~~~~~~~~~~
TranScan's menu system is arranged to provide access to the more
commonly used features first. As you progress through the menu the
options and features become more advanced. The following describes each
menu and prompt in detail. This information is also available by
pressing the <F1> key from any prompt in the menu system.
MAIN
~~~~
There are five selections at the "Main" menu:
Select - Pressing <Enter> here activates the "Select" sub-menu that
<Alt-S> allows you to select which files to process and what
actions you want taken on each of these files.
Process - Pressing <Enter> here tells TranScan to Process the files
<Alt-P> you selected above using the options. You will notice that
you cannot move to this option unless you have selected a
file for processing from the "Select" sub-menu.
Configure - Pressing <Enter> here presents a "Configure" sub-menu that
<Alt-C> allows you to "fine-tune" the way TranScan works on your
system. You can select paths, memory, display, default
compressors and lots more.
Help - Pressing <Enter> here activates a "Help" sub-menu. There
<Alt-H> are only two options on this sub-menu. The first option
"About" tells you important information about TranScan like
version number, registration number and where to call to
order it using Master Card or Visa.
The second option "Help Index" displays an index of all the
online help topics that are available.
Quit - Pressing <Enter> here presents a "Quit" sub-menu. There are
<Alt-Q> two options on this sub menu as well. The first option
allows you to "Exit" TranScan. If you have made any changes
to your configuration without saving them you will be
prompted as to whether or not to save them.
The second option "Drop to DOS" allows you to temporarily
drop to DOS. You can return from DOS by typing EXIT at your
DOS prompt. The second option
I will now describe each of the prompts available at each sub menu.
SELECT <Alt-S>
~~~~~~~~~~~~~~
The "Select" menu is divided into two sections. The top section allows
you to select which files, paths, or drives to process. The bottom
section allows you to select what actions you want taken on each of the
files selected.
Section-I
---------
FileMask - You can change the "FileMask" by pressing <Enter> at this
prompt. You will then be prompted for the "FileMask" you
wish to use. The default is "*.*". Regardless of whether
you select "Files", "Paths" or "Drives" each file will be
compared with this mask before it is processed.
Files - Press <Enter> here and a file selector will appear. It will
display a list of files for the current directory. You can
select a file for processing by moving the cursor to the
file and pressing <space>. You can select or deselect all
the files by pressing <Ctrl-Enter>. You can also change
directories by moving the cursor to a directory name.
However, you can only select files from one directory. If
you change directories your earlier selections will be
unselected.
Speed searching is built-in. To move the cursor to a
specific file you can start typing the filename and the
cursor will move to that file. The letters you type will
appear on the bottom left portion of the frame.
You should notice that the filemask you selected will be
used to determine which files should appear in the
selector. The current directory and filemask are centered
at the top of the frame.
You should also notice that the number of files selected
appears on the bottom of the frame.
When you return from this menu by pressing <Enter> or <Esc>
you will notice that the selector "■" is in the parenthesis
next to "Files". If you move to "Paths" or "Drives" the
selector will move and any prior selections made in files
will be unselected.
Paths - Press <Enter> here and a file directory selector will appear.
You select which directories you want processed by pressing
the <space>. You can select or deselect all the files by
pressing <Ctrl-Enter>.
Speed searching is built-in. To move the cursor to a
specific path you can start typing the pathname and the
cursor will move to that path. The letters you type will
appear on the bottom left portion of the frame.
The number of paths selected will also appear centered at
the bottom of the frame.
Drives - Press <Enter> here and a drive selector will appear.
TranScan will attempt to determine if the drive is ready
and if so what "Disk Type" it is. It will also try to
determine the disk capacity, amount free, and what percent
is free.
You select the drives for processing by pressing the
<space>.
The TranScan drive selector can recognize most drives types
but occasionally it will report "Drive Type Unknown". You
can still select these drives by pressing the <space>.
Speed searching is built-in. To move the cursor to a
specific drive just typing the drive letter and the
cursor will move to that drive.
The number of drives presented in the list is based on your
setting of the "LastDrive" command in your Config.Sys.
Consult your DOS manual for more information.
Section-II
----------
Time Limit -
You can establish a time limit for TranScan to continue
processing. Just enter the time in hours and minutes and
make sure that the selector appears in the brackets like
"[■]". TranScan will process files until this time limit is
reached. It will continue processing the file it is working
on however.
Virus Scan -
You can select whether or not processing will include
Virus Scanning using your selected virus scanners. One
example of when this might not be necessary is when you
have already scanned the files but you wish to convert them
to another archive format.
Compress - You can select whether or not processing will include
Compressing and Converting with this option. You should
also notice that your default compression method is
displayed at this prompt.
GIF & JPG - You can select whether or not GIF & JPG processing will
take place. What processes occur are further determined by
your selections in the configuration.
Add File
Comment - You can select whether or not a ZIP or ARJ comment will be
added to the file after processing.
The options you select here will be saved if you save the
configuration. In this way the options you most frequently use will
always be available.
PROCESS <Alt-P>
~~~~~~~~~~~~~~~
This is like TranScan's "GO" button. After you have made your file,
path, or directory selection you can press <Enter> here and TranScan
will spring into life. You can abort processing by pressing the <Esc>
key (note that TranScan will finish processing the current file before
aborting).
If there are no files, paths, or drives selected this option will not
be available.
CONFIGURE <Alt-C>
~~~~~~~~~~~~~~~~~
There are many options that can be configured. Most of the options are
pre-set and will work without further action. Almost every item on this
sub-menu calls another sub-menu with even more options. Here are the
selections available from the "Configure" sub-menu:
Save Configuration -
After you make changes to your configuration you should be
sure to save these changes.
TranScan Options -
This presents a sub-menu of the numerous options you can
select for TranScan file processing. Each option will be
described in detail below.
FilePath\Name Set-Up -
This presents a sub-menu including the filePath/Name of
asci text files TranScan uses. You can view or edit each of
these files using the built in editor by pressing the <F4>
key.
TranScan Add List -
This presents a sub-menu including the filePath/Name of
asci text files that you want added to each archive
TranScan processes. Possible uses might include a BBS or
User Group advertisement. You can edit these files using
the built in editor by pressing the <F4> key.
External Programs -
This presents an "External Set-Up" sub-menu that allows you
to further select between "Compressors", "Gif Jpg Set-Up"
and "Scanners". Each will be described in detail below.
Display Options -
This presents a "Display Set-Up" sub-menu that allows you
to select "Color Choice" and "Use Mouse?".
Memory Set-Up-
This presents a "Memory" sub-menu that allows you to select
"Overlay Buffer Size:", "Use EMS for Overlay Buffer?" and
"Use EMS for External Swap?".
["Overlay Buffer Size:" and "Use EMS for Overlay Buffer?"
options are not fully implemented yet!]
Work Drive - [C]
The work drive is where all temporary directories will be
created and files extracted. If you have a 2MB Ram Disk you
might wish to select this drive as your work drive. This
will speed up processing tremendously. I would recommend a
minimum of 2MB free for your Work Drive.
Swap Drive - [EMS or C]
The Swap drive is where TranScan will be swapped out if "N"
is selected for "Use EMS for External Swap?" or there is
not enough room in EMS. TranScan swaps out of memory every
time it calls an external program for processing. Again, if
you do not use EMS but you have a ram drive with at least
5K you might wish to select this drive. Again, this will
speed up processing tremendously. I would recommend a
minimum of 5K free for your Swap Drive.
BBS Set-Up -
This presents a "BBS Set-Up" sub-menu with lots of options
that will be described below.
TranScan Options
----------------
At several of the selections you can press the <F2> key to select from
the possible options. You can also press the <space> ,<+>, or <-> keys
to toggle through the options. Notice the bottom line of the screen.
This line displays special keys available and a short description of
the current prompt.
Default Compression Method - [ZIP]
This is the compression method you want all your files
converted to.
Time Stamp Method - [Keep]
TranScan will Time Stamp the compressed file based on your
selection here. Options include:
Keep - Keep the original file date.
Current - Stamp the file with the current date.
Oldest - Stamp the file with the date of the Oldest
file in the archive.
Oldest EXE - Stamp the file with the date of the Oldest
EXE file in the archive.
Youngest - Stamp the file with the date of the Youngest
file in the archive.
Youngest EXE - Stamp the file with the date of the Youngest
EXE file in the archive.
For example, assume the current date is Feb 03, 1993 and
the time is 03:00 am. You process the following archive.
FileName Date Time Time Stamp
-------------- -------- -------- ----------
SAMPLE.ZIP 01/01/93 12:00 am Keep
- VENDOR.TXT 01/01/89 12:00 am Oldest
- UTIL.EXE 01/01/90 12:00 am Oldest EXE
- PRGRM.EXE 01/01/91 12:00 am Youngest EXE
- BBS.ADD 01/01/92 12:00 am Youngest
Computer Clock 02/01/93 03:00 am Current
How you set this option affect the Age/Date Rejection
option below.
Age or Date Reject - [None]
TranScan can reject files that are older than a specific
date or number of days. Press F2 to select "None", "Age",
or "Date". If you do not select "None" you will be asked to
select "Max Age in Days" or "Reject Date". The "Reject
Date" option allows you to select an actual calendar by
pressing the <F2> key.
Date Test GIF Files? - [N]
Selecting "N" to this prompt will exclude GIF files from
being failed by the "Age" or "Date" test.
Min. GIF Resolution [HxWxC] - [0x0x0]
You can indicate the MINIMUM GIF resolution you will accept
here and TranScan will test files against this value. If
you wish to accept all files you should set it to [0x0x0].
Reject Action - [None]
If a file fails the Integrity, Virus, or Age test there are
four options that can be taken. These include "None",
"Rename" the file to "*.BAD", "Delete", or "Move". If you
select move you will then be prompted for the path you
would like these files moved to. Be sure to enter a valid
path here.
Exclude ReCompressing Def? - [N]
If you select yes to this option TranScan will convert
files to your default format but it will not recompress
files already in your default format.
Compress Non-Compressed? - [N]
If you select yes to this option TranScan will compress all
non-compressed files (*.Txt, *.Doc, etc) to your default
compression method.
Compress Imbedded Files? - [N]
Imbedded files are Compressed files inside compressed
files. Sometimes files use INSTALL programs that can only
extract specific types of files. If you receive a lot of
files like this you will probably want to set this to "N".
Convert Self Extract Files? - [N]
Not only can TranScan EXTRACT and SCAN Self Extracting
files, it also has the ability to convert these files to
your default compression method. If you want these files
converted set this to "Y".
Convert -AV Stamped Files? - [N]
[This feature not fully implemented yet!]
TranScan detects the existence of an "Authenticity
Verifaction" stamp on ZIP files. If you select "N" at this
prompt TranScan will not ReCompress these files so that the
original "AV" stamp remains intact.
List files already DID? - [N]
If you select yes to this option TranScan will keep a list
of files already processed so that it will not process them
again. This list is defined below as the TRANSCAN.DID file.
Duplicate File CRC Test? - [Y]
[This feature not fully implemented yet!]
If you select yes to this option TranScan will calculate
each internal files CRC value and compare it against a
duplicate file database. It will then alert you when it
finds a file matching another file already in the database.
This will help you find BBS Adds, Duplicate GIFs, and other
duplicate files.
FilePath\Name Set-Up
--------------------
TranScan uses several external asci text files. You define each of
these files at this sub-menu. You may already have a similar file
already on your system (for example your Zip Comment) so you can just
define these files by typing the complete drive, path, and filename.
You can also use the <F2> to use the file selector. This is the same
file selector described above except you will only be able to select
one file instead of multiple files.
You can also edit these files using the built in editor by pressing
<F4>. The Editor commands and features are described later in this
manual.
TranScanLog -
TranScan maintains a log of its activity. This is where you
define what filename and path to use for this log.
TranScanDel -
During ReCompression or Converting TranScan can delete
files it finds in this list. You can also use wildcards in
this list like "*" and "?". For example:
*BBS.ADD
R&E???.ADD
Be careful what files you include in this list. If TranScan
finds the file in an archive it will delete it.
You can also put a file's CRC value here instead of a name.
Many BBSs change the filename of their BBS.ADD but not the
add itself. That means the filename changes but the CRC
does not. Registered users can use a BONUS utility called
CRCTEST available at TRANSCAN BBS to determine this CRC
value. For this feature to work you also need to set
Configure-TranScan Options "Duplicate File CRC Test?" to
"Y".
In a future version of TranScan the SysOp will be sent a
message alerting them to the possibility of duplicate files
which might be BBS adds. This feature has not yet been
implemented.
TranScanBad -
TranScan maintains a list of all files that it fails due to
Integrity, Viruses, Age or Minimum GIF Resolution. It
writes the filename and path to this file.
TranScanLst -
This list is primarily used by BBS systems to delay part of
the processing of files until later. You can also create an
asci text file containing file paths and names of files you
wish processed in this list. You then run TranScan from the
command line as follows:
TS -L
TranScan will process the files and then delete the list.
TranScanCmt -
This file is the ARJ or ZIP comment you want added to each
file. You should make this comment as small as possible.
File comments are attached to ARJ and ZIP files without
compression. If your comment is 500 bytes and you attach it
to 100 files you will take up 50K of your disk space.
You can have TranScan strip comments by creating a Zero
Byte file. To do this select a filename, enter the editor,
press the <space> bar once then <F2> to save the file and
<Esc> to exit. You should now have an extreemly small file
comment.
TranScanNot -
This file is a list of all the directories and file names
you do not want TranScan to process. In this way you can
protect files or whole file areas or drives from having
their files accidentaly deleted or converted. Possible
directories you might include here would be directories of
old but still valuable files, directories of files with
author AV stamps attached to them, etc. Wildcard characters
like "*" and "?" are acceptable.
TranScanDid -
This file is a list of all the files TranScan has processed
(if the "List files already DID?" option in the "TranScan
Options" sub-menu is selected). This keeps TranScan from
processing a file more than once. Wildcard characters like
"*" and "?" are acceptable.
TranScan Add List
-----------------
This presents a sub-menu including the filePath/Name of ASCII text
files that you want added to each archive TranScan processes. Possible
uses might include a BBS or User Group advertisement. You can edit
these files using the built in editor by pressing the <F4> key.
External Programs
-----------------
This is where all the command line options for all external programs
are defined. I strongly recommend you do not change any command line
unless you have a clear understanding of what you are doing. There are
three choices at this sub-menu:
Compressors -
This is where all the compression programs are defined like
PkZip, PkUnzip, Arj, etc.
Gif Jpg Set-Up -
This is where programs like GIFTest, GIF2JPG, and JPG2JIF
are defined. I recommend you do not change any of the
options here except the "Use this program?" option. For
example if you select "Use this program? Y" to GIF2JPG then
all GIF files TranScan processes will be converted to JPG
files.
Scanners - This is where you set up the command line parameters for
programs like SCAN.EXE by McAfee & Associates. You also
select which virus scanner to use by selecting "Use this
scanner? Y". You can also select more than one scanner to
process files.
Some Virus Scanners will already be defined
for you. I recommend you do not change these settings
unless you are very familiar with the program.
Display Options
---------------
This presents a "Display Set-Up" sub-menu that allows you to select
"Color Choice" and "Use Mouse?".
Memory Set-Up
-------------
This presents a "Memory" sub-menu that allows you to select "Overlay
Buffer Size:", "Use EMS for Overlay Buffer?" and "Use EMS for External
Swap?". ["Overlay Buffer Size:" and "Use EMS for Overlay Buffer?"
options are not fully implemented yet!]
Work Drive [C]
----------
The work drive is where all temporary directories will be created and
files extracted. If you have a 2MB Ram Disk you might wish to select
this drive as your work drive. This will speed up processing
tremendously. I would recommend a minimum of 2MB free for your Work
Drive.
Swap Drive [EMS or C]
----------
The Swap drive is where TranScan will be swapped out if "N" is selected
for "Use EMS for External Swap?" or there is not enough room in EMS.
TranScan swaps out of memory every time it calls an external program
for processing. Again, if you do not use EMS but you have a ram drive
with at least 5K you might wish to select this drive. Again, this will
speed up processing tremendously. I would recommend a minimum of 5K
free for your Swap Drive.
BBS Set-Up
----------
The basic feature of TranScan to UnCompress Files and Scan them for
Viruses will work with EVERY DOS based BBS that can run an event. It
will also display COM output to callers on any BBS that offers a DOS
HOOK immediately following upload of a file (or from external upload
protocols).
Other options are specifically supported in several bulletin boards and
support for more BBS systems will be added in the future.
BBS: [None] -
Press the F2 key to select the BBS software you currently
use. Based on this selection various other options will
become available to you.
In the BBSINFO.DOC file there are instructions for using
TranScan with several popular BBS Systems. You should also
see the "Command Line" section of this document for more
information on setting up TranScan to work with your BBS
software.
Port type: [Uart] -
TranScan currently supports three types of communication
ports: "Uart", "DIGI", and "Fossil". Select the port type
that you use.
Min. Sec. Level: [9999] -
If a user has a security level ABOVE this level his upload
will be processed OFF-LINE in an event. This is available
so that uploads by SysOps and CoSysOps will not be scanned
immediately. It is important to have a filename defined
under "TranScanLst" with this option. [Not available for
some BBS Systems!]
Update Bbs File Date? [N] -
This changes the BBS filedate to the date TranScan stamped
on the file. If your BBS uses a "New File" search that
relies on the BBS File Date I would recommend you select
"N". [Not available for some BBS Systems!]
Add Orphan Files? [Y] -
If TranScan detects a file in a BBS File Path that is not
in the BBS Database it is considered an "Orphan File". If
you select "Y" to this prompt TranScan will add the file to
your BBS Database. [Not available for some BBS Systems!]
Delete Failed Files? [N] -
If you selected "Delete" at the "Reject Action:" prompt in
the "TranScan Options" sub-menu then selecting "Y" to this
prompt will also delete the failed file from the BBS
Database. [Not available for some BBS Systems!]
Write To Activity Log? [Y] -
If this is selected TranScan will write a short message to
the BBS Activity Log after it processes a file online. [Not
available for some BBS Systems!]
Add DESC.SDI file? [N] -
If this option is set to "Y" TranScan will read the file
description entered by the user and if a FILE_ID.DIZ or
DESC.SDI file is not included in the archive TranScan will
add a DESC.SDI file. [Not available for some BBS Systems!]
Compress OffLine? [Y] -
This option allows you to delay compressing and converting
to offline. If this option is selected the filenames will
be added to the file you defined at the "TranScanLst"
option in the "File and Path Configuration" sub-menu. File
names in this list will be preceeded by the '#' sign to
tell TranScan that they have alredy been virus scanned. If
you use this option you can process the files Off-Line with
the following command line:
TS -L
[Not available for some BBS Systems!]
Do GIF/JPGs OffLine? [Y] -
This option allows you to delay processing GIF and JPG
files offline. See "Compress Offline" above for more
information. [Not available for some BBS Systems!]
Gif Short Desc? [N] -
If this option is selected as much of the internal GIF
comment as possible will be added to the Short Description.
[Not available for some BBS Systems!]
Gif Long Desc? [Y] -
This option determines whether or not Internal GIF
descriptions will be imported into the Long Description in
the BBS Database. [Not available for some BBS Systems!]
Gif Resolution? [Right]
This determines where the GIF resolution should appear in
the file description. The options are: NONE, RIGHT or LEFT
of the Short Description, or at the BOTTOM of the Long
Description. [Not available for some BBS Systems!]
BBS Message Conference: [0] -
This is the Mssg. Conference you want "Thank You" messages
sent to users to be placed in. [Not available for some BBS
Systems!]
Send Message? [Y] -
This option allows you to import a message to the user
immediately after they upload a file and TranScan Processes
it. [Not available for some BBS Systems!]
Msg Tear Line? [Y] -
This option determines whether or not the "This message
posted automatically by TranScan" appears in the message to
the user. Turning off this option is only available to
registered users. [Not available for some BBS Systems!]
[The following import messages are only available for the Wildcat v3+
and Wildcat-IM BBS Systems!]
Prompt Default
------------- ------------
Thanks Msg THANKS.IMP
Virus Detected Msg VIRUS.IMP
Failed Integrity Msg INTEGRI.IMP
Failed Age Test Msg AGEREJE.IMP
File Already Exists Msg EXISTS.IMP
No External Program Msg NOEXTPRO.IMP
Extern. Prog. Error Msg EXTPROG.IMP
Fail Min. GIF Res. Msg. MINGIF.IMP
With Wildcat BBS these *.IMP files should be located in the same
directory as the MSGxxxx.DAT file for the conference number you
selected above.
T R A N S C A N ' S C O M M A N D L I N E S
~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~ ~~~~~~~~~~~
TranScan offers a complete set of command line options to allow users
to create special batch files to automate processing. Many options are
logically grouped together. In these cases you follow the first option
with a comma followed by the next option. In these cases it is
important not to put any spaces between the comma and second option.
For example:
TS c:\upload\test.zip /P1,$03F8,4,T /cnone
TS TranScan program name.
c:\upload\test.zip Filename passed to TranScan.
/P1,$03F8,4,T Port information TranScan uses to display info
out the COM Port:
1 = Port Number
$03F8 = Base Address
4 = Irq
T = Use RtsCts flow control
/cnone Do not Convert or Compress the file.
The following is a summary of all the command line options available.
Display Options
---------------
/K Kill the Mouse
/M Force display to Monocrome Mode
/V Force VGA 50 line mode
/? Display command line help
Conversion Options
------------------
/Cext[[,exclude][,everything]]
ext is the file extension of the default compression method
(ZIP, ARJ, ZOO, etc) or NONE if no converting or compressing
should be done.
exclude can be "T" for true or "F" for false to exclude
recompressing files already in the default format.
everything can be "T" for true or "F" for false to compress
all non-compressed (*.TXT, *.DOC, etc) files.
Rejection Options
-----------------
/Adays days is the maximum file age in days that will be accepted.
/R[none or rename or delete or move][,MoveToPath]
defines what rejection action to take. If "move" is selected
you must also include the MoveToPath.
Time Stamp Options
------------------
/T[C or K or Y or O or YE or YO][, UpdateBBS]
C for Current time
K for Keep
Y for Youngest
O for Oldest
YE for Youngest EXE
YO for Oldest EXE
[,updateBBS] T or F for updating the BBS File Date
COM Port Options
----------------
/Pport[,base][,irq][,RtsCts] for standard UART
or
/Pport[,DIGI] for DIGI board
Special Options
---------------
/D or /D- Use TranScanDid File or Don't Use TranScanDid File
/Mminutes Process only for so many minutes
/S Process Sub-Directories
/L Process TranScanLst file
/L[,list] Process list file
/Zfile file is full path to ARJ/ZIP comment file
T R A N S C A N ' S E R R O R L E V E L S
~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~
0 Ok!
1 Virus Detected!
2 Integrity Error!
3 Age Rejection!
4 File Already Exists!
5 External Program Not Found!
6 External Program Error!
7 Failed Min. GIF Resolution Test.
15 User Abort!
16 User Above Min. Sec. Level!
17 Timer Expired!
20 Out of Memory!
21 Fatal Error!
T R A N S C A N ' S E N V I R O N M E N T V A R I A B L E S
~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~
SET TSCFG=
----------
You can include this environment variable before running TranScan to
use a different TranScan Configuration File. Just include the full path
and filename to the new configuration file. TranScan will create this
file if it does not exist and you can configure it. For example:
SET TSCFG=C:\WC30\TS-WC.CFG
This might be your configuration file for using TranScan with Wildcat.
You might have a seperate configuration file for Qmodem-Pro, etc.
You can return to the default configuration file "TS.CFG" located in
the same directory as TranScan (TS.EXE, TS.OVR, and TS.HLP) simply be
removing this variable. For example:
SET TSCFG=
T R A N S C A N ' S B U I L T - I N E D I T O R
~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~
The following Editing Commands are Available:
For Example: ^K represents Control-K
Cursor Movement
<Left> <^S> Cursor left one character
<Right> <^D> Cursor right one character
<^Left> <^A> Cursor left one word
<^Right> <^F> Cursor right one word
<Home> <^Q><S> Cursor to beginning of line
<End> <^Q><D> Cursor to end of line
<Up> <^E> Cursor up one line
<Down> <^X> Cursor down one line
<^W> Scroll up one line
<^Z> Scroll down one line
<PgUp> <^R> Page up
<PgDn> <^C> Page down
<^Home> <^Q><E> Cursor to top of edit window
<^End> <^Q><X> Cursor to bottom of edit window
<^PgUp> <^Q><R> Cursor to beginning of file
<^PgDn> <^Q><C> Cursor to end of file
Insertion and Deletion
<Del> <^G> Delete character at cursor
<Bksp> <^H> Delete character to left of cursor
<^Y> Delete current line
<^Q><Y> Delete from cursor to end of line
<^T> Delete word
<Enter> <^M> Start a new line
<^N> Insert a new line
<Tab> <^I> Move cursor to next tab stop
<^P> Insert control character. Example:
<^P><^G> inserts Control-G
Mode Toggles
<Ins> <^V> Toggle insert mode on/off
<^O><I> Toggle auto-indent mode on/off
<^O><W> Toggle word wrap mode on/off
Text Formatting
<^B> Reformat the current paragraph *
<^K><G> Global Reformat *
* Word wrap must be on.
Other
<^Q><L> Restore original contents of current line
<F1> Display this help screen
<F2> Save file and continue
<Esc> Quit
E X T E R N A L P R O G R A M S N E E D E D
~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~
You are not required to have any of the programs listed below, however,
the functionality of TranScan will be severely limited if any of them
are missing. You can obtain copies of these files by calling TRANSCAN
BBS at 913-266-0781. All of these files are located in area #3 in the
"TranScan Support" files area.
Exe File Version Archive Explanation
~~~~~~~~ ~~~~~~~ ~~~~~~~ ~~~~~~~~~~~
SCAN.EXE 100 SCANV100.ZIP ViruScan program by McAfee & Assoc.
ARJ.EXE 2.30 ARJ230.EXE Process *.arj files
DWC.EXE 5.10 DWC-A510.EXE Process *.dwc files
LHA.EXE 2.12 LHA212.EXE Process *.lzh files
PAK.EXE 2.51 PAK251.EXE Process *.pak & *.sdn files
PKPAK.EXE 3.61 PK361.EXE Process *.arc files
PKUNPAK.EXE 3.61 PK361.EXE Process *.arc files
PKZIP.EXE 2.04c PK204C.EXE Process *.zip files
PKUNZIP.EXE 2.04c PK204C.EXE Process *.zip files
ZOO.EXE 2.01 ZOO201.EXE Process *.zoo files
GIFLITE.EXE 1.22 GIFLITE.ZIP Process *.gif files
GIF2JPG.EXE 1.5 GIF2JPG.ZIP Process *.gif files
JPG2JIF.EXE 1.5 GIF2JPG.ZIP Process *.jpg files
TDCHECK.EXE 2.13 TELED213.ZIP Test *.TD? files (TeleDisk)
T r a n S c a n a n d M e m o r y U s a g e
~~~~~~~~~~~~~~~~~ ~~~~~~~ ~~~~~~~~~~~~~ ~~~~~~~~~~~
TranScan tries to use EMS memory whenever it is available and as much
as available. When EMS memory is not available it must use virtual
memory which in most cases is DISK space. For example, if sufficient
memory is available TranScan will load the Overlay File into EMS. It
will also SWAP the program out of memory into EMS before running any
external programs like PKUNZIP.EXE. If you are concerned about TranScan
using more than its fair share of EMS you can change the amount
available to any given window from the ADVANCED OPTIONS in DESQVIEW.
The value to change is "Maximum Expanded Memory Size (in K):". Every
BBS configuration is different, but here at TranScan BBS I have set
this value to 1000 without any noticeable increase in processing time.
F I L E _ I D . D I Z , D E S C . S D I
~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~
& G I F D E S C R I P T I O N S
~~~ ~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~
The way TranScan handles FILE_ID.DIZ, DESC.SDI, and GIF descriptions
has proven to be one of it's most powerful features. To understand what
it does with these files you should first understand what these
files are.
FILE_ID.DIZ
~~~~~~~~~~~
FILE_ID.DIZ was created by Clark Development for use with their
PCBDescribe utility. It is a means for BBS callers to upload a file
without having to manually type in a file description. It has since
been accepted more-or-less as the "standard" archive file description.
The general opinion is that FILE_ID.DIZ files should ONLY be added by
the program AUTHOR.
The file consists of straight ASCII text, up to 10 lines of text, each
line being no more than 45 characters long. It should not contain any
blank lines, any form of centering or formatting, or any HI-ASCII or
ANSI characters. It is recommeded that it consist of 5 basic parts:
1. The proper name of the program.
2. The version number.
3. The "<ASP>" identifier (optional, for ASP members).
4. The description seperator "-".
5. The description.
The description should attempt to FULLY describe the program, including
its most important functions and features. The author should attempt to
use the first two lines to give a bisic desciption because many BBS
Software programs only use the first 60 to 80 characters.
DESC.SDI
~~~~~~~~
I have not been able to find out much about DESC.SDI files. Some
sources indicate that this file should be a single line of text and yet
others describe a text file several lines long. Unlike the FILE_ID.DIZ
it seems appropriate for NON-AUTHORS to add these files.
In addition to reading these files [in the near future] TranScan will
create these files based on the description entered by the user if
there is neither a FILE_ID.DIZ or DESC.SDI file.
GIF DESCRIPTIONS
~~~~~~~~~~~~~~~~
GIF standard 89a added the possibility of putting Text Comments
inside GIF files. GIFFY-"The GIF Comment Editor", written by the Author
of TranScan, is a BONUS utility for registered TranScan users to view
and edit GIF comments.
TRANSCAN & DESCRIPTION FILES
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Because so few people follow the above described standards, TranScan
will accept and process FILE_ID.DIZ, DESC.SDI, and GIF Descriptions of
any size and format. It will strip HI_ASCII and ANSI characters, and
extra spaces from the description and use word wrapping to import the
description to the BBS.
[This is currently only supported for Wildcat v3+ and PCBoard but more
BBSs will be added in the near future. Also in the near future TranScan
will write the user description to the DESC.SDI file and GIF comments
if description files do not exist.]
GIFFY v0.90a BETA
^^^^^^^^^^^^^^^^^
BETA WIDE VERSION!
Copyright 1993 by Craig E. Dunstan.
ALL RIGHTS RESERVED!
Distribution:
GIFFY is a BONUS utility for REGISTERED users of TranScan - "The
Premium File Scanner & Converter!" It SHOULD NOT be distributed.
Description:
GIFFY is a simple program that tests GIF files. It also provides a
built in GIF Comment editor.
Usage: GIFFY filename[.GIF]
GIFFY will read the GIF file testing all Data Blocks against the GIF
standard. If it detects a problem it will fail the file. If the file
passes and it is a GIF89a file it will then display the comment
editor. You can edit the existing comment or add your own. Pressing
[ESC] will save the comment. A summary will then be displayed and the
program will exit.
I plan on several enhancements to this program in the near future.
TranScan v4.00 has consumed most of my energy. Look for an update of
GIFFY on the TRANSCAN BBS!
Craig Dunstan can be reached at TRANSCAN BBS! at (d) 913-266-0781 or
(v) 913-266-2287.
L
CRCTEST v0.90a BETA
^^^^^^^^^^^^^^^^^^^
BETA WIDE VERSION!
Copyright 1993 by Craig E. Dunstan.
ALL RIGHTS RESERVED!
Distribution:
CRCTEST is a BONUS utility for REGISTERED users of TranScan - "The
Premium File Scanner & Converter!" It SHOULD NOT be distributed.
Description:
CRCTEST is a simple program that tests files to determine their CRC.
Usage: CRCTEST filename.ext
This information can now be used with TranScan. When you detect a BBS
add you can use CRCTEST to calculate the CRC for this file and put the
8 digit CRC value in your TS.DEL file. When TranScan detects a file
with this same CRC value it will delete the file.
CRC values are to files what finger prints are to people. Yes, it is
POSSIBLE for a file to share a CRC value with another file just like it
is possible for a person to have the same finger print. Right?
Actually, the chances are......
1 in 2,147,483,647
(One in Two Billion, One Hundred Forty-Seven Million, Four Hundred
Eighty-Three Thousand, Six Hundred Forty Seven)
I plan on several enhancements to this program in the near future.
TranScan v4.00 has consumed most of my energy. Look for an update of
CRCTEST on the TRANSCAN BBS!
Craig Dunstan can be reached at TRANSCAN BBS! at (d) 913-266-0781 or
(v) 913-266-2287.
**********************************************************************
TranScan Jr. v4.00
**********************************************************************
Copyright 1993 by Craig E. Dunstan. ALL RIGHTS RESERVED!
Distribution:
TRANSCAN JR is a BONUS utility for REGISTERED users of TranScan - "The
Premium File Scanner & Converter!" It SHOULD NOT be distributed.
Description:
TranScan Jr. is a small version of TranScan. It functions EXACTLY the
same except it does not have the set-up screens. Under Desqview running
Wildcat you can use a window as small as 325k.
Your SCANFILE.BAT would only be slightly different as follows:
Regular TranScan TranScan Jr
---------------- -----------
TS %1 TSJR %1
Your DAILY EVENT would also be slightly different as follows:
Regular TranScan TranScan Jr
---------------- -----------
TS -L TSJR -L
By default TranScan looks for the configuration file TS.CFG in the
same directory as TSJR.EXE and TSJR.OVR. This TS.CFG file is created by
TS.EXE so you should put all of these programs in the same directory.
Set-up changes made in TS.EXE will automatically be used with TSJR.EXE.
You can also force TSJR.EXE to read a different configuration by using
the SET TSCFG= environment variable. For example your batch file might
look like this:
SET TSCFG=C:\UTIL\TS.CFG
TSJR.EXE %1
You can also tell when "TranScan Jr" is running because that program
name will appear on the top line of the Screen, the Processing Screen,
and the OnLine Caller Screen.
**********************************************************************
W H A T I S S H A R E W A R E ?
~~~~~~~~~ ~~~~~ ~~~~~~~~~~~~~~~~~~~~~
Shareware distribution gives users a chance to try software before
buying it. If you try a shareware program and continue using it, you
are expected to register. Individual programs differ on details -- some
request registration while others require it, some specify a maximum
trial period. With registration, you get anything from the simple right
to continue using the software to an updated program with printed
manual.
Copyright laws apply to both Shareware and commercial software, and the
copyright holder retains all rights, with a few specific exceptions as
stated below. Shareware authors are accomplished programmers, just like
commercial authors, and the programs are of comparable quality. (In
both cases, there are good programs and bad ones!) The main difference
is in the method of distribution. The author specifically grants the
right to copy and distribute the software, either to all and sundry or
to a specific group. For example, some authors require written
permission before a commercial disk vendor may copy their Shareware.
Shareware is a distribution method, not a type of software. You should
find software that suits your needs and pocketbook, whether it's
commercial or Shareware. The Shareware system makes fitting your needs
easier, because you can try before you buy. And because the overhead is
low, prices are low also. Shareware has the ultimate money-back
guarantee -- if you don't use the product, you don't pay for it.
ASSOCIATION OF SHAREWARE PROFESSIONALS (ASP)
HUB NETWORK (AHN)
--------------------------------------------
In an effort to make it easier for you to obtain your favorite
software, the latest updates of many ASP authored programs can be found
on the BBSs listed below. These BBSs are members of the ASP Hub Network
(AHN).
Zone 1 - East Coast USA
North-East Coast Mid-East Coast
[Site #1] [Site #2]
The Consultant BBS The Break RBBS <East>
Jay Caplan Bruce Jackson
P.O. Box 8571 4660 Whitaker PL
New York NY 10116-4655 Dale City, VA 22193-3011
Data1) 718-837-3236 Data1) 703-680-9269
Data2) Data2) 703-551-0000
Zone 2 - North Mid-USA Zone 3 - Southern Mid-USA
[Site #3] [Site #4]
The Twilight Zone The DataExchange BBS
John Hrusovszky Don Morris
1119 E. Main St 119 Herring St.
Auburndale, WI 54412 Leesville, LA 71446
Data1) 715-652-2758 Data1) 318-239-2122
Data2) Data2)
Zone 4 - West Coast USA
[Site #5] [Site #6]
Attention to Details BBS Space BBS
Clint Bradford Owen Hawkins
5085 Trail Canyon Dr PO Box X
Mira Loma CA 91752 Menlo Park, CA 94026
Data1) 909-681-6221 Data1) 415-323-4398 (ASP Files)
Data2) Data2) 415-323-4193 (Other Files)
Zone 5 - Canada
[Site #7]
Knightec BBS
Phil Knight
35 Robb Blvd #6
Orangeville, ONT L9W 3L1
Data1) 519-940-0007
Data2)
These BBSs are bound by special agreement with the ASP.
In the case of a dispute contact the ASP Omsbudsman.