home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Beijing Paradise BBS Backup
/
PARADISE.ISO
/
software
/
BBSDOORW
/
EZROM120.ZIP
/
EZROM.DOC
< prev
next >
Wrap
Text File
|
1993-05-31
|
53KB
|
1,061 lines
EZ-ROM DOOR
Version 1.20
Released May 31, 1993
Copyright (C) 1993 by Mike Robinson
The Soft Parade
Shelton, Connecticut, USA
1:141/485 203-924-5603
------- OVERVIEW ------------------------------------------------------------
EZ-ROM Door is a file access and download door designed for use on
Wildcat 3.x BBS or any BBS that creates the standard DOOR.SYS file.
Files may be located on CD-ROM disk(s), magnetic disk(s), or both.
It provides browsing, text search and download capabilities from
within the door. It can even track the number of files/bytes
downloaded, enforce daily limits, and then record this information
in the main BBS database. An ASCII text file list is required for
each file area. The door can be run online, locally in the BBS,
and locally from the DOS command line. Up to 100 CD-ROM disks are
supported with up to 500 file areas on each disk.
EZ-ROM can also serve as a very configurable menu extension. From
the same main menu a caller can choose from a selection of CD-ROM
disks, magnetic disk file areas, and external doors. These may be
used in any combination. When an external door is chosen, EZ-ROM
exits with an ErrorLevel which is then used in a batch file to pass
control to the selected external door.
There is special support designed in for multiple nodes and/or
multiple CD-ROM drives such as the Pioneer DRM-600 six disk
changer. Considerable time and energy was spent working around the
speed limitations of today's CD-ROM drives. Actual CD-ROM drive
hardware access time has been minimized by:
1. Maintaining the file lists on the magnetic drive. This is
optional. If the CD-ROM itself contains file lists, these can be
be accessed directly by the door in order to save hard drive
space. The same file lists may be shared by all nodes.
2. Copying the file to a holding directory on the hard drive and
downloading it from there. This is also optional. You can
configure the door to download directly from the CD-ROM drive.
3. Careful design of the the door logic. The CD-ROM drive hardware
is accessed as rapidly as possible and only when absolutely
required.
------- FEATURES ------------------------------------------------------------
■ Multiple disk support for up to 100 disks. Up to 500 separate
file areas per disk. No external menu program required. In fact,
EZ-ROM can also be used as a menu extension. It will display
menus and terminate with an ErrorLevel. You can combine CD-ROMs
and other doors on the same menu. Disks can be put on/off line by
setting one value in the configuration file. Offline disks look
the same as online except no downloads. MegaSearch feature can
search ALL disks for matching text. Separate custom access
control for each disk can be set greater than, less than, or
equal to caller security level. This sets which levels can get
into each disk. In addition, any number of specific security
levels can be set for each disk to allow browse-only access with
no downloads.
■ Batch downloads and file tagging of up to 20 files.
■ Local browse and copy to hard drive mode can be run from
the DOS command line or inside of the BBS. Also copies the
complete description line to an ASCII text file list.
■ Number of files/bytes downloaded is recorded in the BBS main
database and daily download limits are enforced.
■ Almost ANY type of ASCII text file list can be used. File lists
from PCBoard, Spitfire and other ASCII text "FILES.BBS" type of
lists can be used, usually without modification. Such lists are
usually supplied on most of the popular CD-ROM shareware
collections such as NightOwl, So Much Shareware, Pier, etc.
Single and multi-line descriptions are supported.
Also supports Spitfire style multi-line descriptions using the
smiley face (ASCII 02) character.
■ Run as an online door, locally in the BBS, or from the DOS
command line. Low memory requirements. Only uses about 200
kilobytes, which includes the memory required for the DSZ
external protocol.
■ Caller time in door is limited to remaining time allowed on BBS.
■ Download from within door using Xmodem, Ymodem or Zmodem.
A copy of DSZ.COM or DSZ.EXE by Omen Technology Incorporated
is required. Zmodem MobyTurbo is supported.
■ Very rapid text search of both file names and descriptions.
Matches are highlighted in color.
■ File sharing and locking for multinode and network operation. All
file lists, menus, data files and logs may be shared. DOS version
3.0 or higher, with DOS SHARE installed, is required for proper
operation of file sharing and locking. Special collision
avoidance for multi-node and multi-disk. Prevents "thrashing" on
Pioneer multi-disk changer CD-ROM drives.
■ Automatically uses the BBS communication port settings.
Comm port speeds to 115,200 bps with hardware or software flow
control. Uses the BBS configured port speed, data bits, stop
bit, parity, comm port, I/O port and interrupt. Handles any UART.
Does not require or use a FOSSIL driver, but is compatible with a
FOSSIL if one is installed.
■ The door will recognize caller connect speeds of 0, 300, 1200,
2400, 4800, 7200, 9600, 12000, 14400, 16800, 19200.
It will use the value passed by the BBS in DOOR.SYS line 2 to
calculate the estimated download times. Note that sometimes this
value is incorrect. Some systems connect at 12000, 14400, or
16800 but "lie" and tell the BBS that the connect is 9600. The
good news is that the door factors in a speed increase due to
error correction.
■ Carrier detection. Resets the BBS if caller drops carrier.
■ Inactivity timeout configurable from 1 to 10 minutes.
■ Multitasker aware. Releases time slices (clock tics) to tasks
running in other windows when EZ-ROM is idle.
These multitaskers are automatically detected and supported:
Windows 3.x & NT
DESQview 2.xx
DoubleDOS
VMiX 2.xx
MultiDos Plus 4.xx
OS/2 2.0
DOS 5.0 and DOS 6.0 Task Switcher and Compatibles
TaskView, TopView, OmniView, & Compatibles
■ Detailed status lines visible on top of local screen.
Shows caller name, statistics, time left, etc.
■ Detailed status screen displayed during download.
Shows caller's entire download/upload history and more.
■ Local keyboard controls include:
ALT+C --- Chat Mode On/Off
ALT+D --- Drop To DOS (local sysop only)
ALT+J --- Drop To DOS (local sysop only)
F6 ------ Take Five Minutes From Caller
F7 ------ Give Five Minutes To Caller
F10 ----- Exit The Door
ALT+F1 -- Exit The Door
ALT+F2 -- Exit The Door
ALT+K --- Kill. Throw the caller off the BBS *NOW*
■ ANSI color or plain ASCII text modes. Initial mode is the same as
passed by the BBS. Caller can toggle ANSI on/off from within the
door. Door contains its own ANSI driver and can show ANSI
graphics on the local screen even if DOS ANSI.SYS is not loaded.
■ Sysops can design their own (optional) custom screens.
Door will display WELCOME.CLR or WELCOME.BBS before it runs.
(Available in registered versions only).
Place these in the same directory as EZROM.EXE.
If ANSI is on then the .CLR file will be shown, otherwise
the .BBS file will be shown.
■ Several configuration options:
Optional logoff after transfer.
Optional time penalty for dropped carrier.
Configurable number of lines displayed per page.
Can specify the character used in determining which lines in a
file list contain a valid file for tagging and display purposes.
Configurable activity log format.
■ DSZmodem is "trapped" inside a window so that data does not
scroll up off screen as download progresses.
■ Full logging of all caller activities in the door.
------- SETUP for SINGLE-DISK MODE ------------------------------------------
1. Unzip this archive into one subdirectory. This will be the
EZ-ROM home directory, which is named C:\WC30\CDROM in the
following example, but any subdirectory name may be used.
2. Modify the included EZROM.CFG file to meet your needs.
See CONFIGURATION VERBS below for description of each option.
Any line in EZROM.CFG that does not begin with a letter is
ignored. The lines that begin with semicolons, for example, are
used for comments and ignored by the program.
Keep this file in the EZ-ROM home directory.
3. Prepare an ASCII text file list for each subdirectory on the
CD-ROM. These are often included on the CD-ROM and can usually
be used with little or no modification. Keep the lists in the
EZ-ROM home directory or on the CD-ROM. The first line of each
file entry in the list should be in the following format:
....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
EZROM120.ZIP 79,330 05-31-93 EZ-Rom v1.20, CD-ROM Door by Mike Robinson
<---Name---> <-Size--><-Date---><-------------Description------------------- >
This is the standard single line format.
If Spitfire style multi-line descriptions with smiley face
(ASCII 02) character are used, the line may be up to 255
characters long and all on one line. The smiley face marks the
separation between lines. Spitfire multi-line format will be
automatically recognized by EZ-Rom if there is at least one
smiley face on the line.
For other multi-line formats, (such as PCBoard) the description
lines may lie on multiple lines between column 33 and 78 as
shown:
<---Name---> <-Size--><-Date---><-------------Description------------------- >
....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
EZROM120.ZIP 79,330 05-31-93 EZ-Rom v1.20, CD-ROM file download door.
| For Wildcat or any DOOR.SYS BBS.
| CDROM or magnetic drive, Multi-disk,
| Multi-node, Batch download, File tagging,
| Text search, Logs downloads,
| Enforces daily limits. By Mike Robinson
<-------------Description------------------- >
The character "|" is not required, although it is often included
in PCBoard type lists. If it is in column 32 as shown, it will
not be displayed since the description begins in column 33.
Descriptive headers may be used at the top of each file list or
at any point within the list. Any line which does not contain
the tag character at the proper location is assumed to be a
description line and is displayed without modification.
(See TAGCHAR in Configuration Verbs section below.)
4. Modify the included DISK.CLR and DISK.BBS to meet your needs.
These two files are the list of file areas on the disk and are
mandatory or the program will not run. Try to keep these to
under 21 displayed lines or the top may scroll off the screen.
Additional options for these files are described below.
Keep these files in the EZ-ROM home directory.
5. Make sure a copy of DSZ.COM or DSZ.EXE is somewhere on your DOS
path or in the EZ-ROM home directory.
6. (OPTIONAL) Place custom screens in the EZ-ROM home directory.
If they exist, WELCOME.CLR or WELCOME.BBS will be displayed
prior to entering the door. If they exist, GOODBYE.CLR or
GOODBYE.BBS will be displayed after a download if the caller
selects log off after transfer. The .CLR extension indicates
an ANSI file, .BBS is a plain ASCII file.
7. Run the program online via a batch file such as DOOR1.BAT.
The batch file should contain these commands:
CD C:\WC30\CDROM
EZROM C:\WC30\WCWORK\NODE1\DOOR.SYS C:\WC30\CDROM\EZROM.CFG
The complete paths and file names must be specified.
------- SETUP for MULTI-DISK MODE ------------------------------------------
1. Unzip this archive into one subdirectory. This will be the
EZ-ROM home directory, which is named C:\WC30\CDROM in the
following example, but any subdirectory name may be used.
You only need one copy of EZROM.EXE and it must be kept here.
2. Modify the included EZROM.MAS file to meet your needs.
See CONFIGURATION VERBS below for description of each option.
This is the master file that sets the configuration and location
for all of the disks. Any line in EZROM.MAS that does not begin
with a letter is ignored. The lines that begin with semicolons,
for example, are used for comments and ignored by the program.
Keep this file in the EZ-ROM home directory.
3. Create a separate subdirectory for each of your CD-ROM disks.
The general arrangement should look something like this:
┌──────────────┐
│ EZROM.EXE │ EZ-ROM home directory
│ EZROM.MAS │
│ MAIN.BBS/CLR │
└───────┬──────┘
│
┌─────────────────┼─────────────────┬────── - - - etc.
┌──────┴───────┐ ┌──────┴───────┐ ┌──────┴───────┐
│ EZROM.CFG │ │ EZROM.CFG │ │ EZROM.CFG │
│ DISK.BBS/CLR │ │ DISK.BBS/CLR │ │ DISK.BBS/CLR │
│ FILELISTS │ │ FILELISTS │ │ FILELISTS │
└──────────────┘ └──────────────┘ └──────────────┘
subdirectory subdirectory subdirectory
for disk 1 for disk 2 for disk 3
4. Copy EZROM.CFG to each of the disk subdirectories. This is the
configuration file for that disk and must be modified to suit
that disk. EZROM.CFG must contain the disk name and all the
paths to the files and lists for that disk. This is all that
MUST be included, any of the other settings are optional, but
they will be applied if they are there.
5. Prepare an ASCII text file list for each subdirectory on each
CD-ROM disk. These are often included on the CD-ROM and can
usually be used with little or no modification. Keep the lists
in the subdirectory for that disk or on the CD-ROM. See single
disk mode section above for the file list format.
6. Copy DISK.BBS and DISK.CLR to each of the disk subdirectories.
This is the display menu showing the file areas available on the
disk and must be modified to suit the disk. Try to keep these to
under 21 displayed lines or the top may scroll off the screen.
Addition options for these files are described below.
7. Make sure a copy of DSZ.COM or DSZ.EXE is somewhere on your DOS
path or in the EZ-ROM home directory.
8. (OPTIONAL) Place custom screens in the EZ-ROM home directory.
If they exist, WELCOME.CLR or WELCOME.BBS will be displayed
prior to entering the door. If they exist, GOODBYE.CLR or
GOODBYE.BBS will be displayed after a download if the caller
selects log off after transfer. The .CLR extension indicates
an ANSI file, .BBS is a plain ASCII file.
9. Run the program online via a batch file such as DOOR1.BAT.
The batch file should contain these commands:
CD C:\WC30\CDROM
EZROM C:\WC30\WCWORK\NODE1\DOOR.SYS C:\WC30\CDROM\EZROM.MAS
EZ-ROM runs multi-disk mode if config file extension is .MAS.
(Single-disk mode is selected by using extension .CFG)
The complete paths and file names must be specified.
------- LOCAL MODE ---------------------------------------------------------
EZ-ROM may be run in local mode if you log onto the BBS
locally. It may also be run in local mode from the DOS
command line:
CD C:\WC30\CDROM
EZROM LOCAL
If EZROM.MAS is found in the current directory, then multi-disk
mode is selected. If EZROM.CFG is found, then single-disk mode
is run. Local mode allows you to browse the lists, tag files,
and copy the files (and descriptions) to the hard drive.
------- CONFIGURATION VERBS -------------------------------------------------
Configuration verbs are used in EZROM.CFG for both single-disk
mode and multi-disk mode. The program reads each line and if it
begins with a configuration verb, then the configuration is
modified as directed by the verb. If a line begins with
anything other than a letter, it is ignored. The explanatory
comments are on lines beginning with a semicolon and are
therefore ignored. The verbs are NOT case sensitive, but they
must be spelled correctly. The order of the lines is generally
not important except for the DISKS and AREAS verbs.
For multi-disk mode, many of the same configuration verbs are
also used in EZROM.MAS. The configuration verbs in EZROM.MAS are
read into memory when the program starts. When a disk is
selected by the caller, the EZROM.CFG file for that disk is
read. When returning to the main menu from a disk menu, program
startup values are restored from memory. Most of the
configuration verbs can be set in either (or both) the master
EZROM.MAS or the disk specific EZROM.CFG. The values in the
master prevail when the program is at the first menu. The values
for each disk prevail whenever that disk is loaded or read.
DISKNAME So Much Shareware 2
This verb is only used in EZROM.CFG and has no effect in
EZROM.MAS. This name is used in the local status bar display on
the top of the screen and in the door log entries.
COPYTOMAG ON
COPYTOMAG OFF
Choose one. If CopyToMag ON then files will be copied to the
magnetic hard drive just before downloading. These files will
then be erased once the download is completed. If CopyToMag OFF
then the files will be downloaded directly from the CD-ROM
drive. Default is CopyToMag ON
HOLDDIR C:\WC30\CD-HOLD
This is the holding directory where the files are copied to if
CopyToMag is ON. The program also stores the batch download file
list here in all cases. The program takes care of its own
housekeeping and deletes the copied files after the download.
Just the copied files are deleted. Any other files that exist in
this directory will NOT be deleted. In local mode, the files are
also copied here and the descriptions are added to a FILES.BBS
in this subdirectory. If no FILES.BBS exists, one is created.
The default is the root directory C:\.
LOGNAME C:\WC30\ACTIVITY.001
Registered versions only. Gives the name of the caller activity
log file. The default is ACTIVITY.001.
LOG ON
LOG OFF
Choose one. Turns call log ON or OFF.
In unregistered versions the log is forced OFF.
In registered versions the default is Log ON.
In local mode the log is forced OFF.
SHARE ON
SHARE OFF
Choose one. Turns file sharing and locking ON or OFF. File
sharing is generally not required on a single-node BBS. This
program will run much faster with Share OFF. The default is
Share ON.
TIMEOUT 180
This is the caller inactivity timeout delay in SECONDS. If no
keystrokes are received for this length of time, the door will
exit and return the caller to the BBS. Values from 60 to 600
seconds are allowed. The default is 180 seconds (3 minutes).
DEBUG ON
DEBUG OFF
Choose one. Most program error conditions are logged to
EZROM.LOG if Debug is turned on. The program may load a bit
faster if you turn this off. If you are experiencing
difficulties, leave Debug ON. The default is Debug ON.
DIRECTVIDEO ON
DIRECTVIDEO OFF
Choose one. With DirectVideo ON, all local screen writes will
done directly to video memory instead of through the BIOS. The
default is DirectVideo ON. This seems to work fine on most
systems.
CHECKSNOW ON
CHECKSNOW OFF
Choose one. CheckSnow ON enables "snow checking" when using
DirectVideo ON. It has no effect if DirectVideo OFF. Some older
CGA monitors may requires this. It should not be a problem on
most monochrome, EGA or VGA video systems. Some systems may run
a bit faster with CheckSnow OFF. The default is CheckSnow ON.
BIOSSCROLL ON
BIOSSCROLL OFF
Choose one. If BiosScroll OFF, then a special scrolling routine
is used that suppresses snow and flicker on systems with any
kind of color graphics. However, BiosScroll ON is a bit faster.
The default is BiosScroll ON.
DROPPENALTY 300
Number of SECONDS to penalize the caller if carrier is dropped
when in the door. This time will be subtracted from the callers
time allowed during the next call that day. If the caller does
not call back until the next day, then this penalty will have no
effect. Values from 0 to 7200 seconds (0 to 120 minutes) are
allowed. The default is 300 seconds (5 minutes).
ALLOWLOGOFF ON
ALLOWLOGOFF OFF
If AllowLogOff ON then the caller will be offered the option to
select unattended automatic logoff after each download. If you
allow logoff then you can place a copy of your desired logoff
display screen(s) in the EZ-ROM home directory. This is
optional. If this screen exists, it will be shown only after an
automatic logoff.
The default is AllowLogOff ON.
LINESPERPAGE 22
Determines the number of lines shown for each screen page when
the caller is scrolling through the file lists. Values from 5 to
30 lines per page are allowed. The default is 22 lines per page.
TAGCHAR 26 -
This determines the line position and character used to
determine which lines in a file list contain a valid file for
tagging and display purposes. Lines which contain this exact
character at this exact position are colorized and assigned a
tag letter. Lines which do NOT contain this character at this
position are assumed to be header lines or extended description
lines. This option allows the use off many different styles of
file lists.
The default is a dash at position 26 as shown below:
....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+
EZROM120.ZIP 75,085 05-31-93 EZ-Rom CD-ROM Door v1.20 by Mike Robinson
^
character at position (column) 26 is a dash
Examples of common file formats:
TagChar 26 - (tag lines with a dash at position 26) (default)
TagChar 28 - (tag lines with a dash at position 28)
TagChar 26 / (tag lines with a forward slash at position 26)
TagChar 28 / (tag lines with a forward slash at position 28)
TagChar 18 , (tag lines with a comma at position 18 )
Only one character and position may be designated as the
TagChar. If multiple TagChar are specified in EZROM.CFG then the
last TagChar specified is used. For file tagging to work
properly, the file name must be listed first on each line of the
file list (column position 1 to 13);
NODOWNLOAD 10 15 20
This sets no download status for listed security levels.
In the example shown above security levels 10, 15 and 20 are not
allowed to download. Up to 20 levels can be set on one
NoDownLoad line. Use as many lines as your require, each line
beginning with NoDownLoad. If running multi-disk and this verb
is set in EZROM.MAS, then it applies to all disks. If set in
EZROM.CFG then it applies to just one disk. The value in
EZROM.CFG prevails.
AREAS
E:\GAMES1 C:\WC30\CDROM\01.LST
E:\GAMES2 C:\WC30\CDROM\02.LST
E:\EDUCATE C:\WC30\CDROM\03.LST
E:\MUSIC C:\WC30\CDROM\04.LST
E:\GRAPHICS C:\WC30\CDROM\05.LST
E:\CLIPART C:\WC30\CDROM\06.LST
E:\GIFS C:\WC30\CDROM\07.LST
E:\HOBBY C:\WC30\CDROM\08.LST
AREAS
The AREAS configuration verb is a special case. It is only used
in EZROM.CFG, but it is used for both single-disk mode and
multi-disk mode. It is used to signify both the beginning and
end of a list of file areas. The example above shows 8 file
areas, but you can have as many as 500 file areas per disk.
There must be one file area per line. The first line is file
area number 1 and the rest follow in order until you reach the
end.
The list MUST BEGIN and END with the keyword "AREAS".
The list MUST BEGIN and END with the keyword "AREAS".
Each line has two entries separated by at least one blank space.
The first is the path to the file area on the CD-ROM. The second
is the full path and filename of the associated file list. The
list can have any filename.
The file lists can be located on a normal magnetic hard disk or
on the CD-ROM (if they exist on the CD-ROM). The door will run
much faster if you locate the file lists on the normal magnetic
hard disk. Note that you can also use this door to access normal
file areas on your hard drive. You can mix normal file areas
with CD-ROM areas in the same door. The file areas do not have
to reside on the same drive letter or same physical drive. If
you have a network, you can access file areas on a different
machine. You could even put ALL of your BBS file areas in
one or more of these doors. For example, you could put adult
files in one door and restrict access to adults only. Or you
could have special file doors reserved for privileged,
contributing or subscribing callers.
The example above is a portion of the sample EZROM.CFG supplied
in this package. It is for the "So Much Shareware 2" CD-ROM disk
first published in September 1992. The file lists are resident
on the CD-ROM as SFFILES.BBS in each subdirectory and can be
easily copied to a hard drive.
DISKS
1 ON >5 0 C:\WC30\CDROM1\EZROM.CFG
2 ON <30 0 C:\WC30\CDROM2\EZROM.CFG
3 ON =20 0 C:\WC30\CDROM3\EZROM.CFG
4 OFF >5 0 C:\WC30\CDROM4\EZROM.CFG
5 ON >5 20
6 ON >5 0 C:\WC30\CDROM6\EZROM.CFG
DISKS
The DISKS configuration verb is a special case. It is only used
in EZROM.MAS and is for multi-disk mode only. It is used to
signify both the beginning and end of a list of disks. The
example above shows 6 disks, but you can have as many as 100.
There must be one disk per line and they must be on consecutive
lines.
The list MUST BEGIN and END with the keyword "DISKS".
The list MUST BEGIN and END with the keyword "DISKS".
COLUMN 1 is the key character that the caller uses to select the
disk. Number 1 to 6 are shown, but any almost any single
character may be used. This includes letters, numbers and
symbols. Letters must be uppercase. Do not use the letters K,
Q, and S since these are used to select options on the EZ-ROM
main menu. Do not use numbers greater than 9 since these
require more than one character.
COLUMN 2 shows if door is ON or OFF line. If OFF, the disk is
browse-only with no downloads allowed.
COLUMN 3 shows the security level required to enter the disk.
For example if it is set to:
>5 (only security levels greater than 5 may enter)
<30 (only security levels less than 30 may enter)
=20 (only security level equal to 20 may enter)
There must be no spaces between the symbol and the level
number.
COLUMN 4 is the type. Set this to 0 for a CD-ROM disk. Set it
any value between 10 and 255 and EZ-ROM will terminate with
this ErrorLevel when this door is selected by the caller. This
allows EZ-ROM to be used like an external menu program. In
this case, you need to catch and respond to these ErrorLevels
in the batch file that runs EZ-ROM. CD-ROM disks and external
doors may be combined freely in the same menu. A normal EZ-ROM
exit where no door or disk is selected is ErrorLevel 0.
Internal errors in EZ-ROM exit with ErrorLevel 1. Do not set
ErrorLevels 1 to 9 as these are reserved for future use.
COLUMN 5 is the full path and file name of the EZROM.CFG used
for each CD-Rom disk. Create a separate subdirectory for each
disk. Place all the files for that particular disk in the same
subdirectory along with the EZROM.CFG for that disk. Column 5
is blank if this line indicates an external door.
STYLE 1
STYLE 2
Choose one of the style commands shown above. Determines the
style of the download line in the caller activity log entries in
registered versions only. Has no effect in unregistered
versions. Some third party utility programs read the callers log
and count or log downloads. These programs require certain
download log entry styles which are similar to those created by
a normal BBS download.
Two styles are now offered. More will be added if requested.
Only one style may be used in each configuration file. If
multiple styles are specified, then the last one specified is
used.
For Style 1 (Wildcat) a typical log entry looks like this:
* File [ATETRIS.ZIP] downloaded from (Area 1) via Zmodem
For Style 2 a typical log entry looks like this:
* 1800LIST.TXT 2,276 Listing Of 1-800 BBS Systems
BUSYFLAG C:\WC30\CD-HOLD\DRIVE1.BSY
For use in multi-disk mode. Optional. A semaphore marker file
system of collision protection is set by this verb. EZ-ROM
checks for the existence of this busy flag file before each
CD-ROM read. If the file is there, then it waits until the other
node erases the file. EZ-ROM creates this file whenever it
begins to read from the CD-ROM drive and erases this file when
the read is complete. The same busy flag name must be set for
each disk that uses the same drive.
FLAGDELAY 30
For use in multi-disk mode. Optional. Sets the maximum time
in seconds that the door will wait for a busy CD-ROM drive.
The default is 30 seconds which means the door will wait for
up to 30 seconds before halting the attempted disk read
operation and sending a message of "please try again later."
The allowable range is 0 to 300 seconds.
DELOLDFLAG 30
For use in multi-disk mode. Optional. When EZ-ROM encounters a
busyflag, it checks it's age. If it is older than DELOLDFLAG in
minutes, then the flag is deleted. Only the flag declared by the
BusyFlag verb in the same configuration file is deleted. This is
a cleanup feature in case old flags are orphaned by a power
failure or other system problem. The default is 30 minutes which
means the door will delete any flag older than 30 minutes. The
system clocks on a network must be synchronized in order for
this verb to work properly. It is recommended that you set this
value to at least the maximum system time difference between any
2 network nodes. Remember that PC system clocks will drift out
of synchronization over time.
The allowable range is 5 to 720 minutes.
CHECKSIZE ON
CHECKSIZE OFF
Choose one. For use in either multi-disk or single-disk mode.
Optional. The default is CheckSize ON.
If ON, then the CD-ROM drive will be read during file tagging
to determine if the file is actually there and it's size/date.
If OFF, then the CD-ROM will not be read during file tagging.
The file size and date will be read from the file list. This
will speed up the tagging operation and reduce the load on the
CD-ROM drive on multi-node and networked systems. OFF should
work well if your file lists have accurate file sizes and are in
a format where the size is listed in columns 9 to 21.
Note that if the file size in the list is wrong, a caller could
exceed his daily byte or time limit. If set OFF and a file size
cannot be read from the list, then a default size of 50
kilobytes is used. If this verb is used in EZROM.MAS, then it
applies to all disks. If used in EZROM.CFG, it applies to just
one disk.
SOFTFLOW
Do not use this verb unless you are sure you need it.
Flow control is ALWAYS hardware (RTS/CTS) unless this verb is
used. It FORCES software flow control (XON/XOFF) and shuts off
hardware flow control. Hardware flow control is better and most
modern modems support it. If you use software flow control,
please send me a note. I am curious if anyone uses it.
FORCECOMPORT 2
Do not use this verb unless you are sure you need it.
Com port selection is fully automatic based on the value
passed by DOOR.SYS. Use of this verb overides this value
and forces use of the specified com port.
Allowable for this verb is 1 to 8.
Use in EZROM.MAS if running multi-disk mode.
Use in EZROM.CFG if running single-disk mode.
If specified in both, only the value in EZROM.MAS is used.
FORCEBASE $02F8
Do not use this verb unless you are sure you need it.
I/O port base address selection is fully automatic based on
the standard IBM PC values associated with the selected com
port number. Use of this verb overides this value and forces
use of the specified I/O port base address. The $ indicates
that the address is specified as a hexadecimal number.
Allowable for this verb is any value from $02E8 to $5228.
Please note that no checking is done on this value and it
is entirely possible to specify a non-existant base address.
Use in EZROM.MAS if running multi-disk mode.
Use in EZROM.CFG if running single-disk mode.
If specified in both, only the value in EZROM.MAS is used.
FORCEIRQ 3
Do not use this verb unless you are sure you need it.
The IRQ number selection is fully automatic based on the
standard IBM PC values associated with the selected com port
number. Use of this verb overides this value and forces use
of the specified IRQ number.
Allowable for this verb is any value from 0 to 15.
Use in EZROM.MAS if running multi-disk mode.
Use in EZROM.CFG if running single-disk mode.
If specified in both, only the value in EZROM.MAS is used.
FORCEVECTOR 11
Do not use this verb unless you are sure you need it.
The ISR (Interrupt Service Routine) vector number selection
is fully automatic based on the standard IBM PC values
associated with the selected com port number. Use of this
verb overides this value and forces use of the specified
interrupt.
Allowable for this verb is any value from 8 to 15 or from 70 to 77.
Use in EZROM.MAS if running multi-disk mode.
Use in EZROM.CFG if running single-disk mode.
If specified in both, only the value in EZROM.MAS is used.
------- DISPLAY FILES -------------------------------------------------------
In multi-disk mode, the following display files may be used
to show the list of available disks:
ANSI ASCII
----------- -----------
MAINxxx.CLR MAINxxx.BBS
MAINxxx.BBS MAIN.BBS
MAIN.CLR
MAIN.BBS
The "xxx" shown above represents a security level. For example,
MAIN10.CLR is the ANSI menu for security level 10. EZ-ROM
searches for the display files in the order indicated above.
If specific display files are not found for the caller's
security level, then the general MAIN.CLR/BBS files are shown.
In both single-disk mode and multi-disk mode, the following
display files may be used to show the list of available
file areas on a specific disk:
ANSI ASCII
----------- -----------
DISKxxx.CLR DISKxxx.BBS
DISKxxx.BBS DISK.BBS
DISK.CLR
DISK.BBS
The "xxx" shown above represents a security level. For example,
DISK150.BBS is the ASCII menu for security level 150. EZ-ROM
searches for the display files in the order indicated above.
If specific display files are not found for the caller's
security level, then the general DISK.CLR/BBS files are shown.
- MULTI-PAGE MENUS -
You can also create a multi-page MAIN.CLR/BBS and/or
DISK.CLR/BBS. In this case, put all the pages in one file. Each
page should be no more than 21 displayed lines long and there
should be 4 blank lines between each page. The door will pause
at the end of each page and allow the caller to select a command
or scroll to the next page.
------- NOTES ---------------------------------------------------------------
1. EZ-ROM reads all required BBS information from DOOR.SYS, so it
will work fine on any BBS type that can create this file. This
is generally thought of as the "standard" door file. Some
systems (Wildcat, Spitfire, RBBS, GAP, PCBoard, and others) can
generate DOOR.SYS directly, others may require a conversion
program. When EZ-ROM terminates (for any reason) it writes an
updated version of DOOR.SYS, so if your BBS reads DOOR.SYS on
return from a door, the caller information will be updated. I
think GAP BBS is one of the few BBSs that actually does read
back DOOR.SYS. Wildcat reads back USERINFO.DAT and EZ-ROM does
update the information in this file. Support for other BBS types
may be added in the future. So if you would like to see your
BBS type included, please send me a copy of the door file
specification.
2. EZ-ROM uses the powerful and versatile DSZ program from Omen
Technologies for file transfers. DSZ makes available Xmodem,
Ymodem and Zmodem. Zmodem transfers will be sent using 16 bit,
32 bit, or MobyTurbo, as requested by the receiver (caller).
Ymodem transfers will be sent either as true Ymodem or even
Ymodem-g if requested by the caller. To utilize Ymodem-g, the
caller should select <Y>modem in EZ-ROM and then set his
terminal program to receive using Ymodem-g. Ymodem-g will not
work properly unless both the BBS modem and the caller's modem
are set for hardware error correction (such as V.42 or MNP).
Ymodem-g is only available in REGISTERED copies of DSZ.
3. The <S>earch text command searches the entire line so that
all matches in file name, size, date, and description are
shown. This allows some interesting possibilities. For
example, a search for "-93" would show all files with dates
of 1993.
4. Testing here on my system shows that the ASCII text file list
search routines in EZ-ROM are several times faster than searches
of a compiled database and index file. The text file lists also
take up about 1/3 as much space as a compiled database. In most
cases, the text file lists as supplied on each CD-ROM disk can
be used directly with no modification. If space is limited, you
do not have to copy these files to your hard drive. EZ-ROM can
read them right off the CD-ROM if so configured.
------- REGISTRATION --------------------------------------------------------
This is SHAREWARE. You may use this program for a free 30 day trial
period. After that, you must register it or stop using it.
You may give away free copies of this entire unmodified package,
but you may not sell it. I retain all rights to this program.
As an incentive to encourage registration, the following features
are ONLY AVAILABLE IN THE REGISTERED VERSION:
■ The *** UNREGISTERED *** message on the first screen is replaced
by your name and your BBS Name.
■ Wildcat's daily download file and byte limits will be enforced by
the door. The door will also record all downloads and add the
number of files and bytes downloaded to the main Wildcat data
base. So the caller's total daily downloads (sum of downloads
inside the door and normal Wildcat downloads) will never be more
than allowed by Wildcat. These limits are correctly tracked in
any combination, even if the caller enters and exits the door
several times. If Wildcat says a caller can only grab 10 files
per day, he will only be able to grab 10 files total per day.
example:
A caller is allowed 10 downloads per day. He downloads 3 files
in this door. He is then only allowed 7 more downloads when he
returns to Wildcat.
In the unregistered version, only the caller's daily time limit
is enforced. In the unregistered version, downloads are not
recorded and file/byte per day limits are not enforced.
■ WELCOME.CLR or WELCOME.BBS file will be displayed (optional).
■ Full logging of all caller activities in the door to ACTIVITY.xxx
or any file you choose. These log entries are designed to blend
nicely with the normal Wildcat log entries. Other BBS styles will
be added in future version and/or upon request.
Here is an example from a typical Wildcat ACTIVITY.001:
-------------------------------------------------------------------------
23:30 MIKE ROBINSON [FULLUSER] - at 14400 bps on Sun, 05/02/93
* 8 Databits:YES, ANSI Detected:YES, MNP:YES, CONF:14, Time Limit:60
* DOOR #: 1 executed at 23:31
* Entered EZ-Rom at 23:31:49
* Entered So Much Shareware 2 at 23:32:11
* File [TETRIS.ZIP] downloaded from (Area 1) via Zmodem
* Begin Zmodem at 23:32:34 Estimated Time: 0.5 Min.
* End Zmodem at 23:33:01 Actual Time: 0.4 Min.
* Updated download records +1 file(s) and +35,169 bytes.
* Exited So Much Shareware 2 at 23:33:12
* Entered Night Owl 7.0 at 23:33:18
* Exited Night Owl 7.0 at 23:34:54
* Exited EZ-Rom at 23:34:56
* MIKE ROBINSON returned from DOS or DOOR at 23:34
23:35 Signed off NORMALLY. Time Logged: 4 with 53 minutes remaining.
-------------------------------------------------------------------------
In the unregistered version, only error conditions are logged.
No caller activity log is created in the unregistered version.
Registration is $20 (Twenty) US DOLLARS.
Personal check, bank check or money orders are acceptable.
Checks must be from a bank or financial institution with
a cashing address within the USA listed on the front of the
check. Most major banks in other countries can issue such an
international money order or international bank check.
Registered Sysops are entitled to free program support, and free
access to all files and features on my BBS. Support is available
from me on my BBS, in FidoNet (Wildcat echo), Spitfire CircuitNet
(CD-ROM echo) and via direct FidoNet crash netmail. Suggestions for
future improvements from registered Sysops will receive careful
consideration.
In order to register the program, you will have to call my BBS and
download your personal registration key and instruction file. This
key will work for all future versions, so there will be no need to
download any specially compiled versions of the executable program
itself.
If you do not yet have access to my BBS, please be sure to send
along a password and birthdate with your registration. Then I can
set up your logon account in advance. Please be sure to specify
your name and your BBS name exactly as you would like them to
appear on the first door screen.
Your personal registration key and instruction file will be
ready for you to download on the day I receive your check,
usually by 19:00 eastern time.
Registrations will not be mailed.
-------------------------------------------------------
-------------------------------------------------------
-------------------------------------------------------
EZ-ROM 1.20 Door REGISTRATION FORM
Your Name:
(40 characters maximum)
BBS Name:
(40 characters maximum)
BBS Phone Number:
(xxx-xxx-xxxx)
Password to use on Mike Robinson's BBS:
(14 characters maximum)
BirthDate to use on Mike Robinson's BBS:
(mm-dd-yy)
Your Address:
Send this form and $20 (Twenty) US DOLLARS to:
Michael Robinson
9 Richard Boulevard
Shelton, CT. 06484-4386
Personal check, bank check or money orders are acceptable
and must be drawn on a bank in the USA.
-------------------------------------------------------
-------------------------------------------------------
-------------------------------------------------------
InterNet Mike.Robinson@485.n141.z1.fidonet.org
╔═══════════════════╗ ╔══════════════════════╗ ╔═══════════════════╗
║ The Soft Parade ║ ║ Sysop: Mike Robinson ║ ║ 1200 to 16800 bps ║
║ Shelton, CT. USA ║ ║ Spitfire version 3.3 ║ ║ HST V.32bis ║
║ 203-924-5603 ║ ║ Open 24 hours 7 days ║ ║ MNP 5 V.42bis ║
║ FidoNet 1:141/485 ║ ║ CircuitNet 203004 ║ ║ USR Dual Standard ║
╚═══════════════════╝ ╚══════════════════════╝ ╚═══════════════════╝
Latest version of the EZ-ROM Door may be File Requested (freq'ed)
by any Fido compatible mailer 24 hours a day using the
magic name: EZROM
24 hour crash mail & file requests of any file listed in FILES.
Magic Names: EZROM SFROM FILES ABOUT NODELIST NODEDIFF
Legal Stuff:
Use this program at your own risk. No guarantees of any sort.
"WILDCAT!" is Copyright (C) by Mustang Software, Inc.
File sharing and locking implemented via BCSHARE Beta Version 0.7
Copyright (C) By Mike Woltz 1990 Buffalo Creek Software.
DSZ program Copyright by Omen Technology Inc.
EZ-ROM Revision History
Version 1.21 -- May 31, 1993 - Initial Public Release
*******************************************************************
OTHER PROGRAMS BY MIKE ROBINSON:
SFROM120.ZIP 72,955 03-07-93 SF-Rom 1.20 Spitfire CD-ROM Door
SF-Rom Door is a file access and download door designed for use on
Spitfire 3.x BBS. Files may be located on CD-ROM disk(s), magnetic
disk(s), or both. It provides browsing, text search and download
capabilities from within the door. It can even track the number of
files/bytes downloaded, enforce daily limits, and then record this
information in the main Spitfire database. The door can be run
online, locally in the BBS, and locally from the DOS command line.
Up to 100 CD-ROM disks are supported with up to 500 file areas on
each disk.