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