Beijing Paradise BBS Backup

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

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

Wrap

Text File | 1993-02-26 | 15.4 KB | 386 lines

T A P E D O O R Version 4.3 CMS A BBS Door for Remote Tape Access A Utility for Local Tape Access Copyright (c) 1990-1993 by Ray Tracey All rights reserved. Support board is: The U.S.A BBS 508-949-6421 (USR-HST V42) Warranty This product is provided "as is" without warranty of any kind. The entire risk as to the results and performance of the program is assumed by you. Furthermore, the author does not warrant, guarantee, or make any other representations regarding the use of, or the results of the use of the program, and you rely on the program and results solely at your own risk. The author cannot and will not accept responsibility for system damage, loss of profit, or any other special, consequential or incidental damages resulting from the use or inability to use this product. Copyright TAPE DOOR Copyright (c) 1990-93 by Ray Tracey is being distributed as Shareware. Under this concept you may use the SHAREWARE (unregistered) version for a reasonable period of time for evaluation after which you must either register your copy or discontinue usage. Distribution You are encouraged to distribute TAPEDOOR provided that all files contained in the archive are distributed in their original and unmodified state. Description TAPEDOOR is a Remote/Local library Access door for Colorado Tape Drives That will Access a tape drive via a menuing system and restore requested files or volumes from a remote location. REMOTE: systems that are compatible with PCBOARD.SYS, USERS.SYS, DOOR.SYS, CALLINFO.BBS, USERINFO.DAT, SFDOORS.DAT, GTUSER.DAT, TRIBBS.SYS, CHAIN.TXT or DORINFOx.DEF for interfacing to the BBS. LOCAL: ANY Dos Base System. Features Fossil Driver Support --------------------- TapeDoor supports the use of Fossil drivers. To tell your Door to use the Fossil driver instead of the standard COM ports, just put /FD on the command line when running the door. For example: MYDOOR MYDOOR.CFG /FD indicates that a Fossil driver is present and should be used. If no Fossil driver is detected, TapeDoor will print a message to that effect and exit the door gracefully. Environment Variables --------------------- TapeDoor supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ number after the configuration filename. Let's assume your Door is called FOOBAR and you want to use COM1 and IRQ5. The command line passed to your Door would be: FOOBAR FOOBAR.CFG /5 or FOOBAR FOOBAR.CFG /%IRQ% for the environment variable. The /5 tells TapeDoor to use IRQ5 rather than the standard IRQ4 that is normally used with COM1. No /x parameter is needed for the standard IRQ's. When specifying the location of the system file on line 1 of the DOORS.CFG file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%, and %wcnodeid%. Some examples: PCBoard: USERS.SYS in C:\PCB - %pcbdrive%%pcbdir%\USERS.SYS USERS.SYS in C:\PCB\NODE1 - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS Wildcat!: USERINFO.DAT in C:\WC\NODE1 - C:\WC\NODE%wcnodeid% Non-PCBoard systems may use the PCB environment variables by setting them in either AUTOEXEC.BAT or in the batch that runs the door. For example: SET PCBDRIVE=C: SET PCBDIR=\BBSDIR SET PCBNODE=1 - Hard Disk Checking, Tape Door Will check to make sure you have the space required to restore a file before allow a restore. - User Byte Checking, Tape Door Will check the requested file size against the users bytes left before restoring their requested file. this option will only work if the door is running of 1 of the 4 bbs types. PCBOARD.SYS, USERS.SYS, DOOR.SYS <52 LINE> OR CALLINFO.BBS if you are using and bbs that does not make or use one of the files, try and convert your current bbs's system file to one of the above then test the door. Line 8 of the config file will set this option on or off. - Exist, Tape Door Will check the restore path for the existence of the requested file, if the file was previously restored the user is told that file exists on the Hard Drive and to exit the door to download. - Space Bar, when pressed while most menus are being displayed will stop the display and prompt for the next command. - Keyboard time out after 3 min. - Carrier detection - Chat mode - and much, much more!!. MISCELLANEOUS NOTES =================== TapeDoor requires DOS 3.x and up since all files are opened in SHARED mode. When using PCBOARD.SYS, TapeDoor also accesses the USERS file. When using USERS.SYS, TapeDoor also accesses PCBOARD.SYS, PCBOARD.DAT and the USERS file. The DOOR.SYS used by TapeDoor is the standard 52 line GAP (tm) file. The CALLINFO.BBS used by TapeDoor currently contains 36 lines. When creating menus for tapedoor save the files in block mode. Getting Started ---------------- I will attempt to explain how to install Tape Door Step By Step if you Haven't printed this doc, i suggest you do!. ( 1 ) Be sure your TAPE software is in path or in tapedoors directory, Tape Door doesn't restore the file!, Your Colorado software will!. ( 2 ) Preparer a tape for tape door. The best way is to backup file areas straight from the bbs. or use and existing backup for the door. Tape door has to ways of restoring files. the first is to restore files By FileName. By Restoring Files By name a user is prompted for a filename to be restored, tape door will then find the file and restore it for download. The Second method is to restore files by Volume, the user will be prompted for a volume number to restore and the WHOLE volume will be restored. Restoring files by filename is the best way and is somewhat like the same way your bbs's file system runs. we will be needing the total volumes on your tape so remember how many volumes you tape has. ( 3 ) Once you have prepared your tape the next step is to run 43SEARCH.BAT to ease the use of your TAPE SEARCH command, What 43search will do is get a file listing of your tape and store this info in a file called TAPELIST.LST tapedoor will not run if this file does not exist. For more info on using the batch file with the CMD utility view the 43search.bat file. this is the colorado command line needed to make tapelist.lst examp: TAPE SEARCH \*.* /S /V=%1 >> TAPELIST.LST replacing the %1 with the desired volume number to search, repeat this operation till you have all the volumes you want in TAPELIST.LST ( 4 ) TAPELIST.LST now needs to be cleaned up, TAPEFIX.EXE will strip out any unwanted text and separate the volumes by some simple * codes tapefix may be run on tapelist.lst at any time for updating. just run command line in step 3 then run tapefix.exe you may wish to edit tapelist with a text editor?, to do so is easy. the start of each volume will begin with 12 *'s and Volume # then number ************Volume # 1 ^^^^^^^^^^ this text can be found in the file, just delete any unwanted text and add the 12 *'s the next line will be the size of this volume ************10,456,093 ^^^^^^^^^^ This text can also be found. That's it!, remove all lines that contain <DIR> This is what it should look like. ************Volume # 1 ************238,270 QMENU1_6.ZIP 166,776 05-04-1991 10:15 PM \PCB\MAIN\TAPE_DRV\ SFLY10.ZIP 71,494 05-04-1991 10:15 PM \PCB\MAIN\TAPE_DRV\ ************Volume # 2 ************199,989 3DMENU11.ZIP 39,567 10-09-1991 01:18 PM \PCB\MAIN\TAPE_DRV\ CDISK445.ZIP 160,213 10-01-1991 10:45 AM \PCB\MAIN\TAPE_DRV\ ( 5 ) Now that your tape is all set its time to edit your CFG file This file can be of any name but if you wish to run tapedoor with the /LOCAL option the file TAPE43.CFG must exist. Below is a example of your tape43.cfg G:\CODES\TAPEDR43\DOOR.SYS THE U.S.A BBS RAY TRACEY 000000 F Y N G:\BBS\RESTORE\ G:\CODES\TAPEDR43\NODE1\ 10 0 REM line 1 REM line 2 THIS LINE USED BY TAPEDOOR 4.3 IN MAKEING (RESTORE.BAT) REM line 4 REM line 5 REM line 6 ------------------------ End of CFG ------------------------------- line 1: Drive and Path to your BBS's System File line 2: The name of your BBS line 3: Your first name line 4: Your last name line 5: Registration Code line 6: Restore Files by Volume V or by filename F Line 7: Redirect CMS software output to user. Y or N By Redirecting the Colorado software to the caller you won't see the file being restored but they will. Info on who and what's being restored is displayed to you. Line 8: Compare user Bytes left before allowing a restore Y or N line 9: Path to place restored files (be sure to end with a \ ) remember to tell your bbs where to locate the restored files. line 10: Path to DISPLAY FILES (be sure to end with a \ ) TAPELIST.LST, MAIN, POST, HELP FILES, VOLUME, VOLUME # DISPLAY and CMS. the display file are in a self extracting exe called display.exe. For single nodes or multi nodes wishing to use the same menus and tapelist.lst just extract the files in tapedoors home directory. Remember to copy tapelist.lst to what ever directory you have decided to use for your displays. line 11: Your last volume # on tape line 12: Volume Numbers to Excluded (not searched or displayed) 0 for none line 13: RESTORE.BAT Line 1 \ line 14: RESTORE.BAT Line 2 \ line 15: USED BY TAPE DOOR 4.3 line 16: RESTORE.BAT Line 4 \ line 17: RESTORE.BAT Line 5 \ line 18: RESTORE.BAT Line 6 \ Lines 13, 14, 16, 17, 18 are user defined batch commands. these lines are taken in by tape door and are used to make RESTORE.BAT (the file that restores the files) line 15 is used by tapedoor and will place the TAPE RESTORE commands. Tape door also make a second file called RESTORE.DAT that contains info needed to restore files. CMD.EXE can use this file as another way of restoring the file, Read the CMD.DOC in the file CMD-LINE.EXE. ( 6 ) Now your next step should be how to run tape door you read the section (Features, I hope!) it stated what command line option you can use with Tape Door. to run tape door correctly it MUST be run from the supplied Batch file TAPEDOOR.BAT, that may be renamed. below describes this bat file. @ECHO OFF :START43 TAPE43 /LOCAL REM TAPE43 TAPE43.CFG REM TAPE43 NODE1.CFG /5 REM TAPE43 TAPE43.CFG /FD IF ERRORLEVEL 255 GOTO RESTORE IF ERRORLEVEL 254 GOTO END GOTO END :RESTORE CALL-IT RESTORE.BAT DEL LOCKED. DEL RESTORE.BAT REM DEL RESTORE.DAT GOTO START43 :END We show here a local operation of tape door by the command TAPE43 /LOCAL remember with the local option TAPE43.CFG must exist. The ERRORLEVELs are from tape door to this calling batch file, a 255 is passed if the user wishes to restore a file and a errorlevel of 254 is passed if the called wishes to exit the door. THE command CALL-IT RESTORE.BAT, CALL-IT.exe is a exe i made to avoid a drop to dos while using the CTTY command in TAPE DOOR V4.2 and just rather use it instead of the DOS CALL command. Restore.bat are lines 13 thru 18 in the cfg file. tapedoor makes a file called LOCKED to stop all other nodes from accessing your tape drive while a copy of tapedoor is restoring a file, this file must be deleted after restoring a file to allow another restore to take place. each time a caller restores a file tape door will pass all the required information needed to restore a file to RESTORE.DAT. if restore.dat is found tapedoor will just keep appending the restore data to the file. this could be useful if you would like to restore your files as a event or by other means other then using restore.bat info passed to tapedoor.dat is as follows. 1 2 3 4 5 0 HELP.ZIP \PCB\MAIN\TAPE_DRV\HELP.ZIP 2 G:\BBS\RESTORE\ 1 = comport 2 = filename 3 = Directory on the tape where the file is 4 = Volume Number of the file(s) 5 = where the files will be restored If you are restoring files by volume then the filename will = *.* By using CMD and RESTORE.DAT files can be restored as a event!, freeing up online time and restoring files during off-hours. you can even have multy copies of tapedoor (TAPELIST.DAT) and use it as a off-line door. When a caller requests a file RESTORE.DAT will hold that info into you insert the required tape that the user wants the file from. As you can see by using CMD.EXE and RESTORE.DAT files can be restored in a unlimited amount of ways. ( 7 ) Now would be a good time to config you bbs to run the door. ( 8 ) Tapedoor will display files from Tapelist.lst by default, But if you have a Text file that contains a file listing of a volume then just name this file the same number as the volume!. Remember TAPELIST should not be edited for displaying descriptions. example: if you have a listing for volume 1 name this file (1) if you have a listing for volume 2 name this file (2) Its that easy, most bbs's have a listing for its files and in most cases these file areas are placed on the tape. where the default display has no file descriptions (tapelist.lst) you will probley want to use your own. That should get you up and running. There are unlimited ways to restore a file by using tape door. by a event via CMD.EXE and RESTORE.DAT, when the caller logs off! add a ZModem command to your batch file and give the caller the file once it has been restored, del the files restored by the caller Use other tape drives with Tapedoor other than colorado drives. to cut it short what ever a batch file can do! tapedoor can do! Any input on tapedoor is welcome!, call The U.S.A BBS @ 508-949-6421 and leave your comments to the sysop (me). Thanks for Using Tape Door.