home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PCBOARD / TAPEFLAG.ZIP / TAPEFLAG.DOC < prev    next >
Text File  |  1994-03-05  |  10KB  |  230 lines
  1.  
  2.    *   *   *   *   *   *   ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  3.      *   *   *   *   *     █████████████████████████████████████████████████████
  4.    *   *   *   *   *   *
  5.      *   *   *   *   *     ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  6.    *   *   *   *   *   *   █████████████████████████████████████████████████████
  7.      *   *   *   *   *                          TapeFlag
  8.    *   *   *   *   *   *   ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  9.      *   *   *   *   *     █████████████████████████████████████████████████████
  10.    *   *   *   *   *   *        A PPE for flagging files to restore from
  11. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  12. ████████████████████████████████████████████████████████████████████████████████
  13.                                          a Colorado Tape drive.
  14. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  15. ████████████████████████████████████████████████████████████████████████████████
  16.   An adaptation of David Terry's Flag PPE Ver. 3.0
  17. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  18. ████████████████████████████████████████████████████████████████████████████████
  19.   Written & Compiled by Steve Prater
  20. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  21.  
  22. This PPE is released as is, with no warranty expressed or implied.
  23. This PPE is also being released as Freeware, so you may use it for as
  24. long as you like.  I'd like to know if you are using it, and if you need
  25. a modified copy I'd be glad to take care of that too.
  26.  
  27.  
  28. I'd like to thank David Terry of Clark Development Company for his insight
  29. and ingenuity in the creation of FLAG30.PPE.  This TAPEFLAG PPE was created
  30. using his source code and a few of my adaptations to make it work as a
  31. tape restore program.  This PPE is being distributed along with the original
  32. FLAG.PPE v3.0 in accordance with the requirements set forth in David Terry's
  33. FLAG.PPE v3.0 doumentation, and because YOU NEED IT!
  34.  
  35.                            Why another FLAG PPE?
  36.                            
  37.   Having just bought a Colorado Jumbo 250 tape drive, I was all set to
  38. use it as extra storage space for my downloadable files.  I have a 486SLC-40,
  39. 4 megs of ram, and one 210 mb hard drive.  I use QEMM and DesqView 2.42.
  40. Unfortunately, I couldn't get any of the current tape doors to operate
  41. reliably under DV, so I started out to create my own door.  I didn't have much 
  42. luck, and then I found the power of PCBoard's PPL!
  43.  
  44.  
  45.                     What exactly does TAPEFLAG.PPE do?
  46.                     
  47.   TAPEFLAG is a drop-in replacement for FLAG30.PPE.  After you set up a
  48. Tape specific conference (explained later), TAPEFLAG works just like the
  49. original except when the user is in the TAPE conference, TAPEFLAG goes to 
  50. work!  After gathering the appropriate data, it shells out to your tape 
  51. drive software and restores the file.  When it returns from restoring the
  52. file, it stuffs the keyboard just like the original, and leaves the caller
  53. back in the DIRx he was scanning before the restore.
  54.  
  55.  
  56. INSTALLATION:     STEP 1
  57.  
  58.   You MUST have, and install, David Terry's FLAG30.PPE.  It is included
  59. in this package for your convenience.
  60.   
  61.   Next, you must either rename TAPEFLAG.PPE to FLAG.PPE 
  62.                        or
  63.   your must locate prompt #549 in your PCBTEXT file and have it call
  64.   TAPEFLAG. PPE instead of FLAG.PPE.  Either way should work.
  65.  
  66.  
  67. INSTALLATION:     STEP 2
  68.  
  69.   You now have to either assign one of your existing conferences as a
  70. tape specific conference, or create a new conference to be tape specific.
  71. A tape specific conference should have it's own separate DLPATH.LST, DIR, 
  72. and DIRx files.  It cannot point to any files that are stored on the hard 
  73. drive, or on a CD.  Any files found to be available for download within
  74. this conference MUST be located on your tape.  
  75.  
  76. Here's the Why and How that the system of file restoring works this way:
  77.  
  78.    I have one CD drive.  My loving wife bought me a 4 disk CD set from
  79. Night Owl for our anniversary.  So now, I have to rotate my CD's weekly
  80. so the users can get all of them.  Not good!  So, I backed up my Night 
  81. Owl Games CD to tape and made my GAMES conference Tape specific.  
  82.   My DIR for the games conference shows only the 18 file areas that are
  83. contained on the CD.  My DIR1 thru DIR18 files correspond to the matching
  84. \00xA\ directories found on the CD, ie. DIR1 is for the files located in
  85. \001A\, DIR2 is for the files located in \002A\, etc.  
  86.  
  87. THIS IS IMPORTANT!!!
  88.  
  89. One of the drawbacks I found with other tape restore doors\PPEs is that
  90. they want ALL files in one directory on your tape!  Well, guess what?
  91. DOS only lets you have a little over 500 files (I forgot exactly) per
  92. directory.  My full tape has THOUSANDS of files!  I couldn't fit them
  93. all into one subdir of my hard disk prior to backing them up on tape.
  94. Then, if I tried to do 500 hundred at a time, I ended up with mutiple 
  95. volumes on tape!  Other tape doors want just one volume or they want 
  96. the USER TO KNOW THE VOLUME NUMBER!  Really not Good!!  They get confused
  97. easy enough as it is!
  98.  
  99. So now the whole CD is backed up in one volume, with individual subdirs
  100. separating all the file areas.  Much better!  But much harder for you to
  101. set up at first!  Your backed up subdirs MUST be in a 3 digit\1 alpha
  102. character pattern, that correspond to the DIRx.   Example:
  103.  
  104.      BACKED UP SUBDIR                     CORRESPONDING DIRx FILE
  105.  
  106.    g:\001A\filename.zip                        DIR1
  107.            |                                    |
  108.            |                                    |
  109.    g:\018A\filename.zip                        DIR18
  110.    
  111.  
  112. When the user "tags" a file, he is then prompted with:
  113.  
  114.             "What file area are you looking in?"
  115.             
  116. His answer is critical.  If he's scanning DIR1 and answers "1", this
  117. is the key to tape software restore line.  It tells the software to
  118. restore from \001A\ and not \006A\ or any of the other subdirs found on
  119. tape.  If he's scanning DIR1 and answers "2", the tape software will 
  120. abort with a "File not found" error.
  121.  
  122.   This is the only way I could come up with that would restore from
  123. multiple subdirectories, and still have just one volume on tape.
  124.  
  125.  
  126.  
  127. INSTALLATION:     STEP 3
  128.  
  129.   You must create a TAPEFLAG.CFG file and place it in the same dir as
  130. TAPEFLAG.
  131.  
  132.   TAPEFLAG.CFG is as follows.  Here's where setup may get tricky.
  133.  
  134. 18
  135. C:\TAPE\TAPE.EXE
  136. RESTORE
  137. G:\00
  138. D:\WORK\
  139. 1
  140. d:\pcb\ppe\flag\warning.PCB
  141. 1
  142.  
  143. *************************************************************************
  144. Line 1:   The number of file directories you have in your tape specific
  145.           conference (i.e., DIRx).  I have DIR1 thru DIR18, so for my setup
  146.           I have 18 in line 1.
  147.  
  148. Line 2    The complete drive, path and file name for your tape backup 
  149.           software.
  150.           
  151. Line 3    The command needed to run your tape backup in RESTORE mode, as
  152.           if from a .BAT file.
  153.  
  154. Line 4    This is the directory structure as it is on your tape.  The PPE
  155.           will append the user's input (i.e., 1 thru 18) AND the "A\" to
  156.           the end of this line!  If the user enters a 2 or 3 character
  157.           digit, the PPE will strip the appropriate number of zeros!
  158.           
  159. Line 5    The complete drive and path to where you want the files restored.
  160.           Include the trailing "\".  I have my files restored to a temporary
  161.           called D:\WORK\.   This path must be included in your BBS download
  162.           paths list.  Since the restored files have the RO attribute turned
  163.           on, I have my $LOGOFF.BAT run a 
  164.              "if exist d:\work\*.* attrib -r d:\work\*.zip"    
  165.           
  166. Line 6    This is the tape volume number.
  167.  
  168.                                 *** NOTE ***
  169.                                 
  170.               The Colorado Tape software command line has been broken
  171.               up in the config file in preparation of future releases of
  172.               this PPE.  I plan to try to use these bits of information 
  173.               to parse together restore strings for other tape drive 
  174.               software.
  175.               
  176.  
  177. Line 7    Complete path and file name of your warning file.  The warning file
  178.           is what displays to your user, the length of time required to 
  179.           restore the file.  Included is WARNING.PCB as an example.  You
  180.           may edit this file as you see fit.
  181.  
  182. Line 8    Conference Number of your Tape Specific Conference.  If the user's
  183.           current conference is the same conference as listed here, 
  184.           TAPEFLAG.PPE will allow the user to tag a file and it immediately
  185.           goes into the restore mode.  If the current conference is anything
  186.           other than what is listed here, the PPE acts just like SaltAir's 
  187.           FLAG30.PPE
  188.  
  189.  
  190.  
  191. INSTALLATION:     STEP 4
  192.  
  193.   I have to following line added to my $$LOGON.BAT file:
  194.  
  195.       @echo off
  196.       copy d:%PCBDIR%\pcboard.sys d:\work\pcboard%PCBNODE%.sys
  197.  
  198. This sets he stage for what's coming up in the $$LOGOFF.BAT:
  199.  
  200.       @echo off
  201.       if exist d:\work\*.* attrib -r d:\work\*.*
  202.       if exist d:\work\pcboard2.sys goto end
  203.       if exist d:\work\*.zip delf d:\work\*.zip
  204.       :end
  205.       if exist d:\work\pcboard2.sys del d:\work\pcboard2.sys
  206.       
  207. Here's why.  We already talked about the attributes of the restored files.
  208. Line 2 changes them to allow you to delete the files.
  209. Line 3 looks to see what node is logginf off.  I Only allow node 1 to
  210.        restore files.  I don't want a caller logging off of node 2 to 
  211.        delete the files restored by node 1, so if PCBOARD2.SYS exists in 
  212.        the restore, it skips Line 4. 
  213. Line 4 will delete all the files found in the restore directory when 
  214.        node 1 logs off.  You'll need the DELF.COM utility or something
  215.        similiar.
  216.  
  217.  
  218. After all that, you should be ready to start restoring from tape.
  219.  
  220. I'll be more than willing to help any and all that need it when it
  221. comes to setting the stage for this PPE.
  222.  
  223. I'll also make a modified copy for other tape software if someone will
  224. provide me with the command lines!
  225.  
  226. Steve Prater
  227. Le'Cess Poole BBS
  228. Fallon, Nevada
  229. (702)423-6531  14.4
  230. (702)423-6546  14.4