Beijing Paradise BBS Backup

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 | 51.5 KB | 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.