home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR24 / WCAT10.ZIP / README.TXT < prev    next >
Text File  |  1993-11-01  |  11KB  |  207 lines
  1.  
  2.  
  3.         WatchCat 1.0
  4.  
  5.         (c) 1993 by  Felix von Normann and
  6.                      Thomas Opheys
  7.  
  8.         program to recover OS/2 2.x from some kind of hangs
  9.         requires a connector with a switch on a parallel port
  10.  
  11.  
  12.  
  13.         1. INTRODUCTION
  14.  
  15.            Although OS/2 2.x is very stable under normal circumstances, bad
  16.            behaved or defect applications can block keyboard and mouse input
  17.            so that the computer has to be reset. This is frustrating because
  18.            often all processes keep on running and the operating system itself
  19.            is ok - only the user can't input anything.
  20.            With WatchCat, you have another input mechanism that can't be
  21.            prevented from functioning - an external switch on the parallel
  22.            port that can be activated when something blocks the system.
  23.            Unless OS/2 has really crashed and the WatchCat process doesn't
  24.            work either, you can gain back control.
  25.            The WatchCat process runs with very high priority so that is it
  26.            (nearly) guaranteed to become active on a regular basis. Don't
  27.            panic... only every second, some CPU cycles are invested in
  28.            checking a bit on the parallel port - you won't be able to
  29.            measure any performance degradation by this.
  30.  
  31.  
  32.         2. USING WatchCat
  33.  
  34.            Naturally, you have to start WatchCat BEFORE the system hangs  :-)
  35.            It's best to put a Shadow of WATCHCAT.EXE into your Startup Folder
  36.            or generate a new program object. You can i.e. start WatchCat hidden
  37.            so that you don't see anything of it when you boot.
  38.            There are several options you can enter on the command line.
  39.            See below for detailed information.
  40.  
  41.            If you activate the switch on the parallel port, WatchCat opens
  42.            a fullscreen window where a task list is displayed. You can
  43.            configure this display for your own purposes, including sort
  44.            criterium, displaying only PM programs, displaying the full path
  45.            or just the file names, description or no description, ...
  46.  
  47.            From this screen, you can kill any process you want or open a
  48.            fullscreen shell to do other things. Normally, OS/2 hangs are
  49.            caused by a crashed or bad behaved application you know of.
  50.            If you kill this app and go back to the Workplace Shell, everything
  51.            is fine. Sometimes, the Workplace Shell itself hangs. Then it helps
  52.            to kill the PMSHELL process. The WPS will reload automatically.
  53.            If you have no idea what to kill, you are lost and have to try.
  54.  
  55.  
  56.         3. LIMITATIONS
  57.  
  58.            WatchCat can't do wonders. If OS/2 has crashed completely or
  59.            anything has gone too wrong, you have to reboot. But we have
  60.            made the experience that in a lot of cases we could go on working.
  61.            Sometimes we could gain back control and save out work before
  62.            rebooting. And sometimes WatchCat is no help. But in this case,
  63.            NOTHING but rebooting CAN help. If this is the case too often,
  64.            look if something is wrong with your hardware or if you have
  65.            installed a VERY bad driver or application.
  66.  
  67.  
  68.         4. COMMAND LINE SWITCHES
  69.  
  70.            /? or /H   display a little help screen
  71.  
  72.            /C         displays several screens which describe how to build
  73.                       a connector with a switch for the parallel port.
  74.                       Note that this is a somewhat clumsy description, but
  75.                       we are no experts in electrical engineereing (and this
  76.                       wasn't really important to be) - and English isn't
  77.                       our native language.
  78.  
  79.            /A         if you start WatchCat with this option, ALL processes
  80.                       that exist on your system are displayed when you
  81.                       activate the switch. The default is to display only
  82.                       PM programs because they are the ones destined to
  83.                       hang the message queue  :-)
  84.                       At run-time, you can toggle anytime between the two
  85.                       display modes.
  86.  
  87.            /P         If you start WatchCat with this switch, the processes
  88.                       are shown with their full path name. The default is
  89.                       that only the EXE filename is displayed. This option
  90.                       can be changed at run-time, too.
  91.  
  92.            /I=P,B     This lets you use a non-standard parallel port or
  93.                       another input bit. The default is to watch LPT2 for
  94.                       a change in any of the five input bits. You COULD
  95.                       use other hardware with i/o abilities like parallel
  96.                       ports, too. If there is such a device responding on
  97.                       port address 0x389 and you toggle bit 3 with your
  98.                       switch, /I=389,3 should work. Note that the address
  99.                       has to be hexadecimal and it is expected that a byte
  100.                       0xFF can be WRITTEN to this address. The bit that is
  101.                       READ has to be read from the address+1. If you use
  102.                       LPT1 or LPT2 with the kind of connector we describe
  103.                       below, you don't have to worry about this switch.
  104.  
  105.            /Bx        You can change the bit that is checked by WatchCat
  106.                       with this option. Normally, all eight bits are
  107.                       checked automatically. If this conflicts in any way
  108.                       with other things you have connected to your parallel
  109.                       port, you can tell WatchCat to look only for a specific
  110.                       bit and ignore all others. x is the bit number where
  111.                       0 is the least significant one and 7 the most significant
  112.                       one.
  113.  
  114.            /x         With x=1 or x=2, you can tell WatchCat which LPT port
  115.                       should be used. Default is LPT2. If you use the
  116.                       connector on LPT2, use the switch /2.
  117.  
  118.            /T         This lets run WatchCat with time critical priority
  119.                       for the whole time. This isn't needed normally because
  120.                       the polling is always done with high priority. The
  121.                       default is to switch back to regular priority when
  122.                       WatchCat has been activated.
  123.  
  124.            /D         This switch turns off the descriptions beneath the
  125.                       process names. This option cannot be activated or
  126.                       reactivated at run-time, so you have to think if
  127.                       want to see descriptions or not. The default is to
  128.                       display them and I see no reason why this would cause
  129.                       *major* pains  :-)
  130.  
  131.            /S:xxx     where xxx equals "type", "name" or "pid".
  132.                       This lets you choose the initial sort order of the
  133.                       processes. You can sort on application type, the
  134.                       process name or the process id. Can be toggled at
  135.                       run-time.
  136.  
  137.            /@         This is an udocumented switch for Windows NT users.
  138.                       They are known to be using a lot of untested software
  139.                       and undocumented features. So this option will format
  140.                       any Windows NT partition.
  141.                       I fear that everyone EXCEPT NT owners has understood
  142.                       this joke  :-)
  143.  
  144.  
  145.  
  146.         5. THE CONNECTOR
  147.  
  148.            It's so simple... Just go out and buy a 25-pin male SUB-D
  149.            connector that fits to your parallel port, and a switch.
  150.            Now I have one problem: I don't know how such a switch is
  151.            called in English: it's the kind of switches with three
  152.            connections and that can have two states: connecting the pin
  153.            in the middle with the pin on the left or connecting the pin
  154.            in the middle with the pin on the right side:
  155.  
  156.               __         in this position,         __   and in this position,
  157.               \ \        pins 1 and 2 are         / /   pins 2 and 3 are
  158.                \ \       connected               / /    connected.
  159.               __\_\____                      ___/_/___
  160.              |         |                    |         |
  161.              |_________|                    |_________|
  162.               U   U   U                      U   U   U
  163.  
  164.               1   2   3                      1   2   3
  165.  
  166.  
  167.            Connect the following pins:
  168.  
  169.            switch    connector DB-25
  170.            ------    -----------------------------
  171.               1   <-    2  (DATA 0 signal, output)  used as logical HIGH
  172.               2   ->   11  (BUSY signal, input)     used to input the state
  173.               3   <-   19  (GROUND)                 used as logical LOW
  174.  
  175.  
  176.  
  177.            You might also want to use another kind of switch: one that
  178.            simply opens and closes ONE connection. It's just like the one
  179.            that is used as a Turbo Button in your computer case. In fact,
  180.            Felix doesn't use his Turbo Button and now uses it at the
  181.            activation switch for WatchCat. Get a switch that stays in the
  182.            position that you can toggle by pressing it (->Turbo Button...)
  183.            You CAN use one like your case's Reset Button, but you might have
  184.            to hold it down for a while before WatchCat recognizes it.
  185.            You also need one 4.7 kOhm resistor if you want to use such a
  186.            switch:
  187.  
  188.              _________
  189.             |---------|   In this state,            ________     In this state,
  190.            _|_________|_  pins 1 and 2            _|________|_   when pressed,
  191.            |           |  are NOT                |            |  pins 1 and 2
  192.            |___________|  connected.             |____________|  are connected.
  193.               U     U                               U     U
  194.  
  195.               1     2                               1     2
  196.  
  197.  
  198.            Connect one end of the resistor with pin 11, the other end with
  199.            pin 19 of the parallel port connector. Pin 11 is also connected
  200.            to one pin of the switch. The other pin of the switch is connected
  201.            to pin 2 of the parallel port.
  202.  
  203.            I hope everyone can understand what I wanted to say. See the
  204.            README.BMP picture for a little more detailed graphical
  205.            representation.
  206.  
  207.