Beijing Paradise BBS Backup

home *** CD-ROM | disk | FTP | other *** search

/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / ROMBRAIN.ZIP / ROMBRAIN.DOC < prev next >

Wrap

Text File | 1993-04-21 | 15.1 KB | 392 lines

March 3, 1993 ROMBRAIN 2 (C) Copyright 1993 by Stanley Sheff Support BBS: The Brainex System (310) 275-2344 (310) 273-5234 --------------- Welcome to the RomBrain. Now your callers can access your CDROM drive without having to use your BBS's file system. This door works with GAP, PCBoard, Wildcat, Spitfire, WWIV, and RBBS, as well as any BBS that generates a DOOR.SYS file when running a door. RomBrain is a multi-user door and requires SHARE.EXE and DOS 3.3 or above. RomBrain writes user's download stats to DOOR.SYS for BBSes that read this back in to update user information. PCBoard Note ============ Do not SHELL to use this door. Write USERS.SYS and DOOR.SYS when running this door! * RomBrain requires: DSZ.COM or DSZ.EXE in the path. If you have an unregistered DSZ, Y-Modem G protocol will NOT function. If you wish to use GSZ, simply rename GSZ.EXE to DSZ.EXE, or you can edit the batch files that call GSZ. They are located in the BRAINEX directory, and are named: EXTSZ.BAT, EXTS1.BAT, etc. You should add an environment variable to set the dsz log file name, and if using gsz, the window size. If the DSZLOG varible is not set, NO download logs will be written. See the sample Rombrain batch files below. The Brainex Door Manager. If you have not done so, please obtain the file BRAINEX.ZIP, available from the Brainex System. Install the Door Manager before you install Rombrain. Here's what the RomBrain can do: Supports IBM ANSI Color and plain text mode (ASCII) for your callers who don't use IBM characters or don't use ANSI. RomBrain creates an index file from information stored on your CD. Menu Functions: [C]hange CDROM Volume If you use more than one CDROM disk, users may select another disk. RomBrain can detect if the CDROM disk is ONLINE. If it's OFFLINE, they can optionally request a file for download from the Request door. The sysop may optionally have rombrain write a request notification text file. This file is indicated by when setting up the Rombrain with BRAINSET.EXE. [O]ffline requests If you have installed the Request option, users can download requested offline files. [X] Color Toggle Switch between IBM ANSI Color and plain text mode (ASCII). [F]ile Directory Allows you to select one of the CDROM directories. Once you've selected a directory, you may: [D]ownload file(s) You can add names to a list of files for download. The list may be edited. If you use Xmodem Protocol, each file will be sent one at a time, and you will be asked if you wish to continue receiving files from the list. [M]ark a file Add the file name entered to a list to be downloaded later. Just type the letter shown to the left of the filename. 2. [A]rchive View contents of a .ZIP file, Read a file from within the .ZIP file, Transfer (Download) a file from within the .ZIP file, or Download the entire .ZIP file. [S]earch for text within the directory. You may enter all or any part of a word for a search. This function searches filename, date, and description. Selected word will be highlighted in red for color or <brackets> for monochrome. The above commands are available from the Main Menu as well as the Directory Menu. *NOTE: When asked to enter a file name, .ZIP will be added automatically if you do not include an extender. RomBrain Files ---------------- ROMBRAIN.EXE <------------------ RomBrain Program ROMBRAIN.DOC <------------------ Sysop's Information REGISTER.DOC <------------------ Registration information COMPILE.DOC <------------------ Filebase Creator information COMPILE.EXE <------------------ Filebase Creator - Auto Create CUSTOM.EXE <------------------ Filebase Creator - Do it yourself! ROMBRAIN.HLP <------------------ General Help File CDHELP.HLP <------------------ Download Help File WELCOME <------------------ ASCII Welcome Screen WELCOMEG <------------------ ANSI Welcome Screen Also included are files for the optional offline request door. REQUEST.EXE <------------------ Request Program REQUEST.DOC <------------------ Sysop's Information NOTICE.EXE <------------------ Offline Request Notice File Display Prg. NOTICE.DOC <------------------ Instructions for NOTICE.EXE All of these files should be in this ZIP, if they are not, don't take a chance! Call The Brainex System and get a good copy or view the file on a few local boards to see if you can find a complete copy. RomBrain handles all of its file transfers by shelling to DSZ.EXE or DSZ.COM. It is best to use the registered version to enable Y-Modem G. Parameters are passed to the protocol batch files in the following order: %1 - Communications port %2 - Baud rate %3 - File name to send %4 - Node Number (useful for multinode batch files) SETUP ===== This door requires the Brainex Door Manager, available from the Brainex BBS. Once you have configured the door manager, just select the door installation section and answer the questionairre. The setup of RomBrain is simple, all you need to do is create a directory called ROMBRAIN for RomBrain and its files, then copy the files into that directory. 1. Be sure you have the CD you are going to use inserted into your CDROM drive. 2. From the BRAINEX directory, type BRAINSET. 3. Fill in all the required information. 4. Use the COMPILE program if you need to create a filebase for your disk. * NOTE * COMPILE supports these CDs: Night Owl, So Much Shareware, RBBS in a Box, Shareware Grab Bag, So Much Stareware. Ready made file bases are available for download from Brainex BBS. 5. The Compiler will automatically read required information from your CD and create a filebase in the directory indicated by the BRAINSET program. When COMPILE is complete... If you like, you may edit the file CDTYPE_x.4 to customize category names. The "x" will be substituted for CD type. Ex. CDTYPE_A.4 is for type A, CARRS Night Owl CD. The COMPILE program will create the following files: CDTYPE_x.1 CDTYPE_x.2 CDTYPE_x.3 CDTYPE_x.4 (ASCII file of category names. Edit this for accuracy!) ------------------- The file directory menu is generated internally by the RomBrain, but if you wish to use a customized menu, just create your own menu and name it MENUx for ASCII and MENUxG for ANSI. "x" stands for the CD Type (MENUA=CARRS, etc.). Place the MENUx files in the same directory as RomBrain. 4. --------------------------------------------------------------------- MULTIPLE CD FILEBASE OPTION =========================== If you use more than one CD drive, you can use the COMPILE to create a set of data files for each. Example: CARRS CD would have these files: CDTYPE_A.1 CDTYPE_A.2 CDTYPE_A.3 CDTYPE_A.4 RBBS IN A BOX would have these: CDTYPE_C.1 CDTYPE_C.2 CDTYPE_C.3 CDTYPE_C.4 COMPILE will create a directory for each set of cdtype files, then copy the files into the directory you specify. ------------------------------------------------------------------------ Once you have created your filebase, you must then create a batch file to run the door. A batch file for a GAP BBS looks like this: @ECHO OFF SET DSZLOG=LOG1 SET GSZWINDOW=23 ROMBRAIN You can use a fossil driver if you like by adding FOSSIL to the command line such as: ROMBRAIN FOSSIL You will also need to modify your doors menu files and the data file that tells the BBS what your doors are and the security level needed to access them. For GAP, these are respectively: DOORM DOORMG DOORS.DAT Please refer to your BBS documentation for details on setting up these files. For multinode operation, add the node number to the command line: ROMBRAIN NODE=1 or ROMBRAIN NODE=2 etc. You may indicate a different INI file by using the INI= on the command line. Example: ROMBRAIN INI=C:\BRAINEX\ADULT.INI This could contain a completely different setup for cd-roms and user levels. 5. --------------------------------------------------------------------- STARTUP/MENU SCREENS ==================== If you wish to bypass the welcome screen, rename or delete the WELCOME and WELCOMEG files. If you would like to use a different menu screen, create your screen(s) and name them START for ASCII TEXT and STARTG for ANSI menu screen. FILE RATIOS =========== If you wish to enforce an upload/download ratio, you will need to create a RATIO file using any ASCII word processor. The format of the RATIO file is: LEVEL=x RATIO=y Where x=user level and y=number of downloads for each upload. Place each level/ratio on a separate line. Example: LEVEL=50 RATIO=15 LEVEL=90 RATIO=5 LEVEL=100 RATIO=1 Only included levels will be affected by the download ratio. When you have created the RATIO file, place it in the BRAINEX directory, which should also be the location of ROMBRAIN.EXE. BYPASS DOWNLOAD LIMITS (Registered Version) =========================================== Add NOLIMIT to the command line to bypass all download limits. This is useful for BBS types that do not write DOOR.SYS correctly. Rombrain reads the amount of bytes/files available to each user from DOOR.SYS written by the BBS. Example: ROMBRAIN NOLIMIT NODE=1 6. --------------------------------------------------------------------- COREL SCSI DRIVER CDCHANGE.EXE DOS COMMAND PIONEER XDISC.EXE COMMAND ====================================== You can now use this driver with Rombrain and the CD-ROM Jukebox. Place a copy of CDCHANGE.EXE or XDISC.EXE in the BRAINEX directory. EDIT the BRAINEX.INI file using an ASCII editor. Be sure you have a work drive selected in the [ROMBRAIN] section. Change the drive letters in the [CDROM] section. Follow the drive letter with a forward slash / then the slot number. Example: cdrom drive letter=D/3 This cd-rom would be displayed as ONLINE, and would use drive D:, slot 3. You can also set the default cd-rom the same way in the [Rombrain] section of the BRAINEX.INI file. Example: Default cdrom drive letter=D/1 Drive D:, slot 1 would be the default drive. It would always come up as online when the user first enters Rombrain. IMPORTANT: Automatic online cd-rom checking is disabled when using the / option. Be sure the correct cd-rom is in the correct slot! MULTINODE OPERATION WITH CD-ROM CHANGERS It is suggested that you add the WAIT command to the Rombrain command line. This will prevent other nodes from trying to change the cd-rom while a file is being copied to hard disk. Example: ROMBRAIN NODE=1 WAIT You should use the WAIT command on all nodes. Rombrain will create a file named NOCOPY in the BRAINEX directory. When present, other nodes must wait until this file is deleted by the node that is accessing the cd-rom drive. If for some reason you rebooted the machine before this file is removed, Rombrain will not be able to copy files. Simply delete this file to restore normal operation. 7. --------------------------------------------------------------------- # # # The following sysop functions are available while awaiting keyboard input : F5 - Shell to DOS. F8 - Twit user and return to BBS. F10 - Initiate chat with user. ESC to EXIT chat. CF10 - Answer user page bell. Home - Main user stats. End - Displays sysop keys available. PgDn - Secondary user stats. Up Arrow - Increase user's time remaining by 5 minutes. Dn Arrow - Decrease user's time remaining by 5 minutes. One of the nicer features about using the TWIT key, is the user is not told that "the sysop wants them to return to the BBS". Instead, a very plain and simple message of "returning you to the BBS" is displayed. This way, the user is given no indication that the sysop is hovering about. When using the F5 shell to DOS key, to return to the door program, simply type EXIT at the DOS command prompt. It is not necessary to change directories back to the door directory. RomBrain is smart enough to know which drive and directory the door program is in and will reset the defaults upon return from DOS. The Up and Down Arrow keys increase and decrease the user's time respectively by 5 minutes for each press of the key. There is no indication of what is occurring (except by the fact the user's time remaining will change), so the sysop should try not to have a lead finger. The increase or decrease is effective only while the user is in RomBrain. This version of RomBrain is a DEMO. File Transfers are limited to 300,000 bytes and 2 files per session. It will become full featured upon registration. This door is released "As Is" and there is *NO* warranty or guarantee that it will work for you and not cause any problems. You have chosen to use this door, YOU are responsible for any unfortunate problems that may develop from its use or misuse. I will gladly listen to any suggestions or problems you may have, and I will do my best to fix whatever needs to be fixed. I can not be held responsible for any problems you may have, whether directly or indirectly due to the use of the door or its utilities or associated files. Please be sure the program works for you before you register! Please read REGISTER.DOC for information on how you can register your copy of RomBrain. The download option will only work on a registered version. For complete support, contact Stanley Sheff on The Brainex System. Your questions will be quickly and cheerfully answered! Stanley Sheff The Brainex System 310-275-2344 BBS 310-273-5234 BBS 310-275-5833 Voice (10am-6pm PST)