home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / TAPECV12.ZIP / TAPECV.DOC < prev    next >
Encoding:
Text File  |  1993-09-02  |  6.2 KB  |  147 lines
  1.  
  2.                       User's Guide to TAPECV12.EXE
  3.                             Revised 09/02/93
  4.                               By Bob Lange
  5.  
  6. OVERVIEW:
  7.  
  8. A few months ago, I leaped at the chance to get a Colorado Trakker 250
  9. for my system at home.  I thought, "Gee, now I can stop playing the
  10. floppy shuffle!"  But then, after I had successfully converted several
  11. hundred diskettes to tape, an ugly daemon raised it's head.
  12.  
  13. In the past, I had struggled to keep track of my files on disk, and had
  14. eventually settled on using a shareware program that satisfied most of
  15. my needs.  The problem was, this program read file directories directly
  16. from diskette, and had no import capabilities.  Nor did it (or any other
  17. shareware file indexing software for that matter) read directories on
  18. tape.
  19.  
  20. The tape drive, on the other hand, had a rudimentary print routine, but
  21. it was cluttered with directory information, a la the DOS TREE program,
  22. and defied any simple, one-step process to convert the file information
  23. to a more usable format.
  24.  
  25. The few utilities that I had seen on bulletin boards that purported to
  26. do tape-specific file indexing were pitiful indeed.  One even trashed
  27. the directory on one of my tapes.  Beware of amateur programmer's
  28. attempts to read the Jumbo tape header; I lost dozens of megabytes by
  29. trusting someone else's claims trying this.
  30.  
  31. Colorado's BBS had little to offer in the way of hard-core information
  32. about how to access the tape header itself, so I turned to my own
  33. meager programming skills to solve the problem.  Hence TAPECV.
  34.  
  35.  
  36. PURPOSE:
  37.  
  38. This program reads the ASCII printed output from the Colorado Memory
  39. System's TAPE.EXE program from disk and generates a comma-separated file
  40. suitable for import into just about anybody's general database software.
  41.  
  42. Umm, might not be as clear as it should be.  Let me restate that.
  43.  
  44. You have to print a list of the files that are on a volume with Colorado
  45. Memory Systems' TAPE.EXE program for this program to process.  No other
  46. file can yield any results.
  47.  
  48. LEGALESE:
  49.  
  50.                                  TAPECV  V1.20
  51.  
  52.                         Copyright (c) 1993  by Bob Lange
  53.  
  54.                               All Rights Reserved
  55.  
  56.  
  57.                                    DISCLAIMER
  58.  
  59.             The  program author, Robert A. Lange, hereby  disclaims  all
  60.        warranties relating to this product, whether express or  implied,
  61.        including   without   limitation  any   implied   warranties   or
  62.        merchantability or fitness for a particular purpose.  The  author
  63.        cannot  and  will  not be liable  for  any  special,  incidental,
  64.        consequential, indirect or similar damages due to loss of data or
  65.        any  other  reason, even if the author has been  advised  of  the
  66.        possibility of such damages.  In no event shall the liability for
  67.        any  damages  ever exceed the price paid for the license  to  use
  68.        software, regardless of the form and/or extent of the claim.  The
  69.        user  of  this  program  bears all risk as  to  the  quality  and
  70.        performance of the software.
  71.  
  72. There!  Now that's out of the way.  Sheesh.
  73.  
  74.  
  75. PRICING:
  76.  
  77. None.  Nada.  Zilch.  I don't need money that bad, despite the fact that
  78. I'm an out-of-work programmer.  If you want to send me money, well,
  79. contact me and we'll work something out.  But this isn't freeware.  I
  80. reserve all rights, and will probably do so forever.
  81.  
  82.  
  83. INSTALLATION:
  84.  
  85. Stick the executable in your utilities or tools directory or anywhere on
  86. the path. Alternatively, you could stick it in the same directory that
  87. your Jumbo software is in.  No other files are necessary.
  88.  
  89. USING IT:
  90.  
  91. First, put a tape in the drive, then run the software that came with
  92. your Colorado Memory Systems tape drive (TAPE.EXE).  For you Windows
  93. users this is the tape menu icon.
  94.  
  95. To generate a listing for TAPECV to process, select "View" from the top
  96. line, then select "Tape Directory." (Whirr, whirr, whirr ...) The
  97. volumes recorded on the tape will appear in a scrolling window.  Select
  98. whichever volume you want to create a listing from with the mouse or
  99. cursor arrows.  Then select "View Dir."
  100.  
  101. The drive will position the tape to the volume's file directory. (Whirr,
  102. whirr, whirr ...) Now, select "Print Dir" and you will get an input
  103. screen that asks for a filename to be written to, and a redirection
  104. option.  Make sure that "Print to file" is 'X'ed and then select "OK" to
  105. begin printing.  It's very fast; don't blink, or you may miss it!
  106.  
  107. A cautionary note here:  Colorado's print routine does not check for the
  108. prior existance of a file, and does not append, so if you use the same
  109. name over and over (likely if you accept the default) only the last
  110. fileset printed will be printed on disk.
  111.  
  112. Now, execute TAPECV with the file to be processed on the command line in
  113. the following fashion:
  114.  
  115.         TAPECV12 [tape_dir.prn]
  116.  
  117. You will be prompted for a file to process if you neglect to enter it on
  118. the command line. A rotating progress indicator is displayed, indicating
  119. every valid filename found. If successful, a new file containing the
  120. comma-separated list of the files that were in that volume will be on
  121. your hard disk.
  122.  
  123. The program uses the source filename with an extension of ASC for the
  124. destination filename, so don't use ASC as an extension when naming the
  125. source file. There should be no problem with any filename that DOS
  126. considers legal, so be warned.
  127.  
  128. For your convenience, I have included the field names as the first
  129. record. The records generated by this program are: Filename, Extension,
  130. Date, Time, Size, Tape, Volume Number, and Volume Name.
  131.  
  132. I've also include a similar utility to convert PCBoard-style listings,
  133. called PCBCV10, to ASCII comma-delimited files.  All of the instructions
  134. given above for TAPECV12 hold true for this program also.  The records
  135. generated from this program are: Filename, Extension, Size, Date, and
  136. Comment.
  137.  
  138.  
  139. COMMUNICATE WITH ME:
  140.  
  141. This program has been tested with the printed output from Colorado
  142. Memory Systems TAPE.EXE (Trakker) version 3.06, and no other versions.
  143. Bug reports should be directed to me at one of the following resources:
  144.  
  145.         GEnie, where I am R.LANGE7
  146.         Aquila BBS (708) 820-8805 14.4, where I am Bob Lange
  147.