home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / fish / devs&handlers / btntape / tapemon / tapemon.doc < prev    next >
Text File  |  1990-10-27  |  4KB  |  81 lines
  1. ****    TapeMon:  a monitor program for BTNtape handler           ****
  2. ****       Version 1.0   09/10/90                                 ****
  3. ****       Freeware by Bob Rethemeyer   (DrBob@cup.portal.com)    ****
  4. ****      (c) Copyright 1990  Robert Rethemeyer                   ****
  5.  
  6. TapeMon is an optional companion program to the BTNtape SCSIdirect
  7. tape handler.  Since the handler cannot directly inform you of what
  8. it is doing,  TapeMon, running in a separate CLI, communicates with
  9. the handler and prints information for you.  Think of it as a window
  10. into the handler.
  11.  
  12. To run TapeMon, bring up a separate CLI window.  Enter "TapeMon" or
  13. "TapeMon name", where name is the name of the handler device process.
  14. If you do not enter the name, the monitor will default to using "TAPE".
  15. If you do enter the name, it must be in uppercase letters, and must
  16. not have an ending colon.
  17.  
  18. The handler must be loaded and running for TapeMon to work.  Otherwise
  19. it prints a message and immediately quits.  If you have mounted the
  20. tape handler but not accessed the tape yet, the handler is not yet loaded,
  21. and TapeMon will give up.  To avoid this, invoke TapeMon after starting
  22. tape access, or use "Mount = 1" in your mountlist entry.
  23.  
  24. Once the handler is loaded and running, you may invoke or terminate
  25. the monitor at any time (but only one TapeMon may run at a time).
  26. To terminate the monitor, enter control-C from the TapeMon CLI window,
  27. or send a BREAK command from another CLI.
  28.  
  29. If the handler encounters a tape error, it remembers the data returned
  30. by SENSE.  When TapeMon is started, it prints the retained sense data.
  31. So if you weren't running TapeMon at the time an error occurs, you can
  32. still see the sense data by starting TapeMon after the fact.
  33.  
  34. The following summarizes the messages from the handler/monitor:
  35.  
  36.   Opened at block x         printed when the TAPE: file is opened by DOS.
  37.                             x is the first block number of the file.
  38.  
  39.   Closed at block x         printed when the TAPE: file is closed by DOS.
  40.                             x is the next available block.
  41.  
  42.   Writing block x * n       printed when a tape write is started by the
  43.                             handler. x = starting block, n = number of blocks
  44.  
  45.   Reading block x * n       printed when a tape read is started by the handler.
  46.  
  47.   Unsupported_pkt= x        printed when DOS sends a packet which the handler
  48.                             rejects.  Example: 25 for the INFO command.
  49.  
  50.   Rewinding                 printed when handler starts a tape rewind
  51.  
  52.   Raw command               printed when handler receives a raw command request
  53.  
  54.   Last sense= x,yy          retained sense data printed at TapeMon startup
  55.  
  56.   Sense: io_Error= z  Sense= x,yy    printed when the handler issues SENSE
  57.                                      to the tape drive.  z is the Amiga
  58.                                      error code returned by the scsi driver,
  59.                                      n is the basic sense code returned by
  60.                                      the drive, and yy is the extended sense.
  61.  
  62.   Capacity: xxxx * yyyy = zzzzzzzz   prints the capacity of the tape volume.
  63.                                      x is the number of blocks on the tape,
  64.                                      y is the size of a block, and z is the
  65.                                      total volume capacity in bytes.
  66.  
  67.   Can't get memory for tape buffers   printed for Open() attempts when not
  68.                                       enough memory is available for buffers.
  69.  
  70.   Time for a new tape                printed when EOT requester displayed
  71.  
  72.  
  73. HOW IT WORKS
  74.  
  75. TapeMon works by finding the tape handler process and locating a common
  76. data structure attached to it.  The monitor waits for signals from the
  77. handler.  The handler detects the presence of the monitor and signals
  78. it when a message needs to be printed.  A break signal causes the monitor
  79. to disconnect itself from the handler and terminate.
  80.  
  81.