home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / monitr15.zip / Monitor.txt < prev    next >
Text File  |  1996-04-13  |  5KB  |  109 lines
  1. Monitor v1.5
  2.  
  3.  
  4. Syntax:  Monitor <COMNAME> <...>
  5.  
  6. Example: Monitor Com3 Com4
  7.          Watches Com3 and Com4.
  8.  
  9. Synopsis:
  10.   Monitor provides modem lights for those of us who have internal modems.
  11. New features (from 1.1) include a pop-up menu (rt click), the ability to
  12. drag w/o a titlebar (use left mouse button), and it now remembers where it
  13. was and what the settings were.  Different ports will remember their
  14. positions/settings individually.  If you get really messed up, you can erase
  15. all of the saved settings by deleting the Monitor.Ini file (now it will stay
  16. in the executable's dir).
  17.  
  18.   Since many people have asked for explanations of the settings, here goes
  19. (Note that building a help file is in the ToDo list ;-)
  20.  
  21.        The Interval slider controls how often Monitor samples the port.  In
  22.    the red region (30-80 ms), Monitor runs at TimeCritical priority so that 
  23.    it will pre-empt most other programs.  In the blue region, it runs at 
  24.    Server priority; either way, it tries to be nice to OS/2 by only sampling
  25.    every <n> ms.
  26.  
  27.        The Signals section doesn't work yet (await v. 2.0).  I don't think
  28.    this is a good way to select the signals; I am open to suggestions (see
  29.    postscript).
  30.  
  31.        If something doesn't read what is in the port in the time given by the
  32.    Bit Eater slider, Monitor will flush the port and optionally drop the DTR 
  33.    if the Bit Eater is enabled.  The RD LED can remain lit forever without
  34.    activating the Bit Eater; the Bit Eater is reset every time something has 
  35.    removed *any* bytes from the port.  You can tell when the Bit Eater gets
  36.    hungry because it will change the BaudRate indicator to "...." shortly
  37.    before it munches down.  New from 1.2b.
  38.  
  39.        The "Always On Top" and "Remove From TaskList" options are controlled
  40.    by value-sets (though I want to make them into a 4 state checkbox to save 
  41.    space).  The Red minus will clear the setting from all windows.  Selecting
  42.    the blank option removes the setting from the current window.  The green
  43.    checkmark applies it to the current window, and the blue plus sets the 
  44.    option for all windows. New from 1.2b.
  45.  
  46.   See buglist.txt and ToDo.txt to see what I have planned for the future.
  47. See the end of this document and the History.Txt and Signals.Txt files for
  48. a more in-depth discussion of the menus/options/controls/indicators.  
  49. Or just play!
  50.  
  51. Caveats:
  52.   This does not work with programs the lock the com port when they open it
  53. (Ckermit!!!).  It does, however, work with DOIP and many comm programs. With 
  54. some set-ups, the order which you fire up Monitor & the other apps may be 
  55. important.  Since Monitor holds the comm port open, OS/2 will not 
  56. automatically drop DTR when the other app exits.  The other app must 
  57. *explicitly* drop DTR or you can tell Monitor to drop DTR when the bit eater
  58. becomes active.
  59.  
  60.   Monitor does not attempt to analyze the data streams, so it has no idea what
  61. is being sent accross the wire (be it TCP/IP packets, whatever).  This means 
  62. that it can't provide you with the modem-modem link speed (unless you have the
  63. port set to auto fall back... not a good idea).  I *might* be able to get CPS
  64. rates into the program, but it will be a while.
  65.  
  66.   Also, if some data comes accross the modem (like RING), but nothing reads 
  67. the data from the comm port, the RD light will stay on, indicating that there
  68. is data to be read (unless the bit eater is enabled).
  69.  
  70.   This program was tested with Ray Gwinn's SIO drivers, but should work with 
  71. the standard OS/2 drivers.
  72.  
  73.  
  74. Price: 
  75.   This Version is FREE, but donations are always accepted.
  76.  
  77. Standard Disclaimer:
  78.   This program has NO warranties or guarantees.  I, Thor Johnson, may not be
  79. held liable for any consequences of this program.  If you cannot live with 
  80. these terms, do not use this program.
  81.  
  82. Postscript:
  83. If you didn't discover the secret last time, unzip the archive with Info-Zip, 
  84. and view this file with EPM.  Voila!  Color!  Fonts!
  85.  
  86. Hey, if you like/dislike the security system, drop me a note!  Let me know if 
  87. you even care about it.  
  88.  
  89. I need some help:
  90.  
  91.   1. Why don't text controls react all the time (on my 8MB [yes, I am 
  92.     DEVELOPING on 8MB] system, the Baud rate indicator may/may not initialize
  93.     ok)?
  94.  
  95.   2. How would you like to set the controls?  (Bear in mind that the LED's 
  96.     can be/are twice the size of text)
  97.  
  98.   3. Does anyone use the font/color pallettes to customize their Monitor, 
  99.     and should I save that?
  100.  
  101.   4. If you get a message box with "Internal Error," please let me know!  
  102.     This message is embedded in places where something went drastically
  103.     wrong.
  104.  
  105. Plans for version 2.0:  This will be in a while (~1.5 month, hopefully).  I'm
  106. going to make version 2.0 Shareware (maybe meterware).
  107.  
  108. -Thor Johnson
  109.