home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 1 / CDPD_Vol1.bin / pd / 551-575 / 558 / btntape / tapemon.doc < prev    next >
Text File  |  1992-06-23  |  4KB  |  90 lines
  1. ****    TapeMon:  a monitor program for BTNtape handler           ****
  2. ****       Version 2.1     /  /91                                 ****
  3. ****       Freeware by Bob Rethemeyer   (DrBob@cup.portal.com)    ****
  4. ****      (c) Copyright 1990,1991 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.  
  16. The handler must be loaded and running for TapeMon to work, otherwise
  17. it prints a message and immediately quits.  If you have mounted the
  18. tape handler but not accessed the tape yet, the handler is not yet loaded,
  19. and TapeMon will give up.  To avoid this, invoke TapeMon after starting
  20. tape access, or use "Mount = 1" in your mountlist entry.
  21.  
  22. Once the handler is loaded and running, you may invoke or terminate
  23. the monitor at any time (but only one TapeMon may run at a time).
  24. To terminate the monitor, enter control-C from the TapeMon CLI window,
  25. or send a BREAK command from another CLI.
  26.  
  27. If the handler encounters a tape error, it remembers the data returned
  28. by SENSE.  When TapeMon is started, it prints the retained sense data.
  29. So if you weren't running TapeMon at the time an error occurs, you can
  30. still see the sense data by starting TapeMon after the fact.
  31.  
  32. TapeMon accepts a second command line argument as a flag to print all
  33. the sense information when a sense occurs.  The value of the second
  34. argument is ignored, but if it is present, complete sense is printed.
  35. Example:  TAPEMON TAPE: ALL
  36. The presense of the ALL will cause the sense message to also print
  37. 32 bytes of hex sense information as it is returned from the drive.
  38.  
  39. TapeMon output is to stdout, so you may redirect it if you like.
  40. Example:   TAPEMON >filename
  41.  
  42.  
  43. MESSAGES
  44.  
  45. See the file "mess.doc" for messages originating from the handler.
  46. The following summarizes the messages from the monitor:
  47.  
  48.   Process ? not found       the device name doesn't match the BTN mountlist
  49.  
  50.   No linkage structure...   the device name is not that of BTN, or BTN
  51.                             hasn't started up yet (when Mount = 0)
  52.  
  53.   Process doesn't look      the device name is for something other than BTN,
  54.     like BTN-Tape           or the TapeMon version doesn't match BTN's.
  55.  
  56.   There is already a        only one copy of TapeMon can talk to a BTN process
  57.     TapeMon running         at once.
  58.  
  59.   Handler has no signal     cannot talk to handler (these should be rare)
  60.   Unable to allocate
  61.     signal for TapeMon
  62.  
  63.   ?.device Unit-?  LU-?     shows information from mountlist
  64.  
  65.   Drive: ............       shows the manufacturer, model, and ROM version
  66.                             of the drive.  This is the data returned by the
  67.                             drive with the SCSI INQUIRY command.
  68.  
  69.   Sequential Access         One of the first two messages is printed to show
  70.   Direct Access             which type of drive you have.  The third message
  71.   BAD LOGICAL UNIT NUMBER   is printed if you use the wrong L-U number.
  72.  
  73.   Last sense= ?????, yy,zz  retained sense data printed at TapeMon startup
  74.  
  75.   ERROR(S) IN STARTUP       printed when the handler detects an unrecognized
  76.                             parameter in the mountlist Startup statement.
  77.  
  78.   TapeMon terminated        monitor has successfully disconnect from handler
  79.  
  80.  
  81.  
  82. HOW IT WORKS
  83.  
  84. TapeMon finds the tape handler process and locates a common
  85. data structure attached to it.  The monitor waits for signals from the
  86. handler.  The handler detects the presence of the monitor and signals
  87. it when a message needs to be printed.  A break signal causes the monitor
  88. to disconnect itself from the handler and terminate.
  89.  
  90.