home *** CD-ROM | disk | FTP | other *** search
/ Lion Share / lionsharecd.iso / bbs_oth / offlin11.zip / OFFLINE.DOC < prev    next >
Text File  |  1991-04-19  |  15KB  |  427 lines
  1.  
  2.  
  3.                    OFFLINE TAPE DOOR
  4.                     (C)1991
  5.               Written by Mark Chickering
  6.             Supported by Terrapin Flyer BBS
  7.             RIME Member  Node ID ->TERRAPIN
  8.                  BBS Phone 703-886-7825
  9.  
  10.  
  11.                                 -------------
  12.                               REGISTRATION FORM
  13.                                 -------------
  14.  
  15.  
  16.      Name:___________________________________________________________
  17.  
  18.   Company and or BBS:________________________________________________
  19.  
  20.   Address:___________________________________________________________
  21.  
  22.           ___________________________________________________________
  23.  
  24.   VOICE Phone:____________________ DATA Phone:_______________________
  25.  
  26.  
  27.  
  28.   Register OFFLINE FILE DOOR To:
  29.  
  30.   Name:_______________________________________(40 Characters or LESS)
  31.  
  32.   Password Desired on Terrapin Flyer BBS _____________________________
  33.  
  34.   Once Registration is Recieved you will be given access to Conference 16
  35.   on Terrapin Flyer BBS where you can Download the latest Verion of this and
  36.   other TEREWARE DOORS
  37.  
  38.   Please find enclosed a check or money order for $20.- payable in
  39.   United States Currency to: MARK CHICKERING
  40.  
  41.   I understand that OFFLINE FILE DOOR is provided AS IS and without warranties
  42.   of any kind, expressed or otherwise. I am using OFFLINE FILE DOOR it at my
  43.   own risk.
  44.  
  45.   Signed: _________________________________________  Date: _________
  46.  
  47.  
  48. Return to: MARK CHICKERING
  49.            P.O. BOX 1834
  50.            Staunton, VA 24401
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. OFFLINE TAPE DOOR allows you to use your 40 or 80 Megabyte MOUNTAIN tape drive
  68. as a TAPE ROM.  Adding upto 80 megabytes of file space instantly!  OFFLINE
  69. TAPE DOOR turns your tape drive into some well needed convenient storage
  70. space and better than that...IT WORKS...most restore times take less than 1
  71. minute! (depending on tape size and number of volumes)
  72. The door also has more than adequate security features.  With proper usage
  73. of the .VOL files you can control whether or not a file, multiple files or
  74. complete Tape Volumes are out of reach of users...so the whole tape does not
  75. have to be comitted to the BBS!
  76.  
  77. SUPPORT: I can be reached via RIME (RELAY-NET) or through my BBS.
  78.      REGISTERED users will be provided with my HOME voice #
  79.      through which I will be more than happy to provide VOICE
  80.      support.
  81.      Any Comments/suggestions are more than welcome....
  82.  
  83. THIS DOCUMENTATION: Its 2:00am and I hate writting documentation almost
  84.      as much as I enjoy writing programs but I am going to give
  85.      it my best shot!  I have tried to explain EVERYTHING as simply
  86.      as possible....setup is really not as bad as it looks and the
  87.      time spent will be well worth the 40 to 80 megs you gain!
  88.  
  89. SETUP:
  90. Setup is not complicated!  The most time consuming part is backing-up your
  91. files if you have not done so already.  Below is a list of steps that you
  92. should follow EXPLICITLY to ensure that OFFLINE TAPE DOOR works properly
  93. the FIRST time! (Believe me I hate DOC's as much as you do so I will make
  94. this as short as possible!
  95.  
  96. 1 Copy Files:
  97. -------------
  98. Copy the ALL files included in this .ZIP into your MTN_TAPE directory.
  99.  
  100. FILES that are needed by OFFLINE TAPE DOOR are:
  101.       ONE OF THE FOLLOWING IS REQUIRED
  102.  
  103.     OFFLNA1.EXE    #= PCBOARD VERSION of .EXE file
  104.     OFFLNB1.EXE    #= DOOR.SYS/GENERIC.SYS/DORINFO.DEF VERSION of .EXE file
  105.     OFFLNC1.EXE    #= WILDCAT! VERSION of .EXE file
  106.  
  107.       ALL OF THE FOLLOWING ARE REQUIRED:
  108.  
  109.     OFFLINE.INS    ONLINE instructions for Door Users (Edit as you wish)
  110.     OFFLINE.VOL    **Sample VOLUME CONTROL FILE            *See Below!!!
  111.     SYSOPS.VOL    **Sample SYSOPS Volume list file.       *See Below!!!
  112.     COMPRESS.VOL    **Sample COMPRESSION Volume list file.  *See Below!!!
  113.     OFFLINE.CFG    Door Configuration file               *See Below!!!
  114.     OFFLINE.DOC    You are reading it now!
  115.     OFFLINE.    **Sample offline Batch file for PCBOARD (Copy to \PCB)
  116.  
  117.  
  118.  
  119.  
  120. ** Sample .VOL files provided as EXAMPLES ONLY and should be altered or
  121. Deleted after reading Documentation!
  122.  
  123.  
  124. 2 Create the DOOR Batch file
  125. ----------------------------
  126.  
  127.     If you do not know how to install a DOOR in your BBS you should
  128. consult your Bulletin Board System's documentation. Other than that ALL
  129. commands to start OFFLINE#.EXE and tell it which BBS and comm port  it
  130. is running on are passed on the command line. The Door SHOULD be started
  131. from its default directory!
  132.     
  133. EXAMPLE BATCH FILE
  134.     
  135.     cd\mtn_tape
  136.     offline.exe (w/ commandline parameters *See Below!!)
  137.     cd\pcb
  138.     board
  139.  
  140. *COMMAND LINE PARAMETERS:
  141.  
  142. PCBOARD
  143.  
  144.     OFFLINE#.EXE C:\PCB\PCBOARD.SYS C:\PCB\USERS 1
  145.         │  ┌────────────┘     ┌──────┘  ┌───────┘
  146.         │  │                  │         └ COMM PORT 1 2 or 0
  147.             │  │         PATH and NAME of PCBoard USERS file
  148.         │  └─PATH and NAME of PCBOARD.SYS file
  149.         └ OFFLINE TAPE DOOR .EXE FILE
  150.  
  151. DOOR.SYS Users!
  152.  
  153.       OFFLNB1.EXE C:\BBS\DOOR.SYS
  154.         │  ┌────────────┘
  155.         │  │
  156.         │  └─PATH and NAME of DOOR.SYS file
  157.         └ OFFLINE TAPE DOOR .EXE FILE
  158.     
  159. WILDCAT! Users!
  160.  
  161.       OFFLNC1.EXE C:\WC\CALLINFO.BBS 1
  162.         │  ┌────────────┘     ┌──────┘
  163.         │  │                  └ COMM PORT 1 2 or 0
  164.         │  │
  165.         │  └─PATH and NAME of CALLINFO.BBS file
  166.         └ OFFLINE TAPE DOOR .EXE FILE
  167.  
  168. QBBS/RBBS users
  169.  
  170.       OFFLNB1.EXE C:\RBBS\DORINFO1.DEF
  171.         │  ┌────────────┘
  172.         │  │
  173.         │  └─PATH and NAME of DORINFO.DEF file
  174.         └ OFFLINE TAPE DOOR .EXE FILE
  175.     
  176. ALL OTHER BBS TYPES!
  177.  
  178.     The Door has the ability to read a 3 line GENERIC.SYS file
  179.     which can be created by the sysop of the BBS allowing the
  180.     Door to run on ANY BBS!
  181.  
  182.     GENERIC.SYS is as follows:
  183.     line 1 - BBS Operators Name
  184.     line 2 - Comm port (COM1: COM2: or COM0:)
  185.     line 3 - Time Allowed in Door ( in minutes for example 20 )
  186.  
  187.  
  188.     OFFLNB1.EXE C:\BBS\GENERIC.SYS
  189.         │  ┌────────────┘
  190.         │  │
  191.         │  └─PATH and NAME of GENERIC.SYS file
  192.         └ OFFLINE TAPE DOOR .EXE FILE
  193.  
  194.  
  195.  
  196. 3 Create Restore Directory
  197. --------------------------
  198. Create a DIRECTORY for your files to be restored to. THIS IS ONE OF THE
  199. MOST IMPORTANT STEPS! CREATE A NEW DIRECTORY, IT CANNOT BE A NESTED DIRECTORY!
  200. On My BBS it is called C:\OFFLINE and my TAPE.EXE files are in C:\MTN_TAPE\
  201. Both of these directories MUST be on the SAME drive! Now add the directory
  202. to THE TOP (LINE ONE) of your DOWNLOAD PATH file (in pcboard this is your
  203. DLPATH.LST file) If you do not add this directory to the TOP of the
  204. DOWNLOAD PATH LIST then it will result in the message "0 Length file found
  205. aborting file transfer" being diplayed when the user attempts to download a
  206. restored file.
  207.  
  208. 4 Create OFFLINE.CFG file
  209. -------------------------
  210.  
  211. the offline config file consists of 4 lines as follows:
  212.  
  213. line 1 - PATH which Door is run from AND contains TAPE.EXE
  214.      on my BBS this is C:\MTN_TAPE\
  215. line 2 - NAME of directory (NOT PATH!!) that you created in step 3
  216.      on my BBS this is simply the word OFFLINE
  217.  
  218.  
  219. -- Commercial Break....go get a beer and light another cigarette! <grin>
  220.   WHAT??..We are down to line 147 and you haven't thrown the docs out yet!
  221.   "Captain, I don't think she can take any more..."
  222.  
  223.  
  224. 5 Prepare a Volume For Offline Tape Door
  225. ----------------------------------------
  226.  
  227. KEEP This in mind while backing up files: Tape volume names MUST be ONE word
  228. ANY LENGTH but one word!  For Example:
  229.     GAMES
  230.     COMPRESSION
  231.     DESK_TOP
  232.     DIR1
  233.     CONF1
  234. Are all acceptable Volume names.  UNACCEPTABLE NAMES are names with a
  235. SPACE in the first 8 characters. For Example:
  236.     SYSOPS FILES
  237.     DIR ONE
  238.     DIR 1
  239. Theretically Two word volumes with no spaces in the first 8 characters
  240. should be alright although I have never tried them. For Example:
  241.     COMPRESSION FILES
  242.     COMMUNICATIONS FILES
  243. If you are curious as to the reason for this I will tell you BUT it will
  244. take either a call to my bbs or a message sent over RIME...for the sake of
  245. keeping these docs short I will refrain...
  246.  
  247. STEP 5-A
  248. --------
  249. NOW...crank up TAPE.EXE and make a Backup...just a small one to check
  250. things out! Lets give it a volume name of TESTING  and put whatever
  251. you want in the "label field" and back up say 10 files from a directory.
  252.  
  253. STEP 5-B
  254. --------
  255. I have included a utility....written by somebody else...in the ZIP file.
  256. It is now time to use that utility....its called VPRINT5.ZIP.
  257. The Utility redirects your printer output to disk....Unzip the file into your
  258. MTN_TAPE directory and start it with the command line:
  259.     
  260.          VPRINT TESTING.VOL /i
  261.  
  262. 1. Restart TAPE.EXE and enter the date and time.
  263. 2. Select DIRECTORY from the TAPE MENU
  264. 3. Cursor up to Position Volume by: TABLE and press <Enter>
  265. 4. Move your cursor to the volume you created that we called TESTING and press
  266.     <enter> you should be returned to the TAPE DIRECTORY MENU
  267.     and  get the message "Volume found"
  268. 5. In the Bottom left it says "Printer format" cursor to this and press "Y"
  269.     so that Printer format says YES
  270. 6. Cursor up to Current Volume Display and pres <Enter>
  271. 7. Press Space Bar to return to menu
  272. 8. Quit Tape.EXE and return to DOS
  273.  
  274. Type the following commands at your Dos Prompt
  275.  
  276. VPRINT /f        <- this FLUSHES Buffers to disk
  277. and
  278. VPRINT /d        <- this DISABLES VPRINT
  279.  
  280. This flushed a DIRECTORY of your TAPE VOLUME-> TESTING to a file called
  281. TESTING.VOL
  282.  
  283. NOTE: typing "VPRINT ?" at your dos prompt will provide you with a complete
  284. list of VPRINT commands!
  285.  
  286. STEP 5-C
  287. --------
  288. You now want to edit this file using a programmers editor and REMOVE ALL
  289. but the directory entries for example:
  290.  
  291. Contents of TESTING.VOL file BEFORE EDITING:
  292. ---------------------------Beginning Of File---------------------------
  293. Tape Directory                                             Page 1
  294. Selective Backup on Saturday, April 13, 1991 at 18:06
  295.  
  296. Tape #: 1
  297. Label: COMPRESSION
  298. Desc: PCBOARD COMPRESSION FILES
  299. Source: F
  300. Size (bytes): 492,321
  301. Available on tape (bytes): 30,970,880
  302. File redirection permitted
  303.  
  304. Directory: \
  305.  
  306. COMPRES       <DIR>      6-07-90  5:54p
  307.  
  308. Directory: \COMPRES
  309.  
  310. &LHARCX3 EXE     70912   8-11-90 11:38p
  311. A2Z13    ZIP         0  10-07-90  9:46p
  312. AZP5010  ZIP     30518   7-16-90  4:47p
  313. COMP              2125   1-13-91  7:53a
  314. COMP     BAK      2194   9-26-90 12:11a
  315. CVT-21   ZIP         0  10-07-90  9:46p
  316. LHARC    EXE     31256   5-31-89 11:38a
  317. PCP      ZIP     14828   2-09-90 12:46p
  318. PKX35A35 EXE     71808   9-09-87  7:07p
  319. PKZ110   EXE    149536   6-21-90  5:52p
  320. SHEZ57   ZIP    117765   7-25-90  3:54p
  321.  
  322.          11 files in this volume
  323.           1 directories in this volume
  324. ------------------------------End Of File------------------------------
  325.  
  326. Contents of TESTING.VOL AFTER EDITING
  327. ---------------------------Beginning Of File---------------------------
  328. &LHARCX3 EXE     70912   8-11-90 11:38p
  329. A2Z13    ZIP         0  10-07-90  9:46p
  330. AZP5010  ZIP     30518   7-16-90  4:47p
  331. COMP              2125   1-13-91  7:53a
  332. COMP     BAK      2194   9-26-90 12:11a
  333. CVT-21   ZIP         0  10-07-90  9:46p
  334. LHARC    EXE     31256   5-31-89 11:38a
  335. PCP      ZIP     14828   2-09-90 12:46p
  336. PKX35A35 EXE     71808   9-09-87  7:07p
  337. PKZ110   EXE    149536   6-21-90  5:52p
  338. SHEZ57   ZIP    117765   7-25-90  3:54p
  339. ------------------------------End Of File-----------------------------
  340.  
  341. Step 5-D
  342. --------
  343. All that remains is to add the Volume TESTING to the master volume file
  344. called OFFLINE.VOL. At this point you only want OFFLINE.VOL to contain ONE
  345. line and that is the name of your new volume
  346.  
  347. TESTING
  348.  
  349. NOTE: OFFLINE TAPE DOOR checks the file OFFLINE.VOL Before restoring a file
  350. from tape IF the volume is not listed in OFFLINE.VOL nothing will be restored
  351. from that volume.  The same goes for the volume file lists.  If a filename is
  352. not found in the corresponding .VOL file (for example TESTING.VOL) the file
  353. would not be restored even though it is on the tape in volume TESTING
  354.  
  355. To ADD more volumes to the OFFLINE TAPE DOOR repeat all parts of STEP 5.
  356.  
  357. Note that Corresponding Volume List files for volumes LESS than 8 letters
  358. will be called the volume name with an extension of .VOL for example:
  359.  
  360. The file list for SYSOPS volume is SYSOPS.VOL
  361. The file List for GAMES volume is GAMES.VOL
  362.  
  363. The Corresponding Volume List Files for Volumes with MORE than 8 letters
  364. will be the volume names first 8 letters with an extension of .VOL
  365. for example:
  366.  
  367. The file list for COMMUNICATIONS volume is COMMUNIC.VOL
  368. The file list for COMPRESSION volume is COMPRESS.VOL
  369.  
  370. REGISTRATION:
  371. -------------
  372. Quite a bit of work went into this DOOR! The UNREGISTERED screen and related
  373. garbage (personally I hate wasting time programming  it almost as much as
  374. much as you hate looking at it!) will be disabled upon registration and addition
  375. of the serial code and your bbs name to the OFFLINE.CFG file. Registration
  376. requires that the form (below) and $20.00 (Check or M/O) be sent to my address.
  377. The Required Serial Code will then be made available to you that will register
  378. this and all future releases of OFFLINE TAPE DOOR. Please allow 2 weeks from
  379. date you mail the registatration!
  380.  
  381.                                   Thank-You For You Support!
  382.                      .\\ark Chickering
  383.  
  384. My Address:
  385.      Mark Chickering
  386.      P.O. BOX 1834
  387.      STAUNTON VA.  24401
  388.  
  389. LICENSE/WARRANTY:
  390. -----------------
  391. You have NO LICENSE expressed or implied to use this product for a period
  392. of more than 10 days from the date received.  ALL RIGHTS RESERVED.
  393. SUBJECT TO CHANGE WITHOUT NOTICE!
  394.  
  395. I make no warranty of any kind, express or implied, including without
  396. limitation, any warranties of merchantability and/or fitness for a particular
  397. purpose.  I shall not be held liable for any  damages, whether direct, indirect,
  398. special or consequential arising from a failure  of this program to operate in
  399. the manner desired by the user.  I shall not be held liable for any damage to
  400. data or property which may be caused directly or indirectly by the use of
  401. this program. In no event will I be held liable for any damages, including
  402. (but not limited to) any lost profits, lost savings or other incidental or
  403. consequential damages arising out of the use or inability to use this program,
  404. or for any claim by any other party.
  405.  
  406. DISTRIBUTION:
  407. -------------
  408. This program can be freely distributed as SHAREWARE! in its ORIGINAL .ZIP
  409. file only.  ANY alterations to the ZIP file or to the program itself is a
  410. willful TERMINATION OF LICENSURE.
  411.  
  412. MULTINODE SYSTEMS:
  413. ------------------
  414.  
  415. OFFLINE FILE DOOR  may be used on a multi node system provided a separate
  416. batch file is maintained for each node.  Desqview users may experience
  417. problems with MOUNTAIN DRIVES TAPE.EXE FILE.  Any DV user who succeeds in
  418. getting TAPE.EXE to run under DV is invide to tell me his DV settings!
  419.  
  420. WATCHDOG/CTTY:
  421. --------------
  422. CTTY and WATCHDOG are not required. If carrier is lost, it will return
  423. to the system where the user will then be logged off.
  424.  
  425.  
  426.  
  427.