home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 357.lha / AlertManager / Alert.Doc < prev    next >
Encoding:
Text File  |  1990-03-13  |  3.5 KB  |  188 lines
  1.  
  2.  
  3.      Page 1                    Alert Manager                    Page 1
  4.  
  5.  
  6.                                Alert Manager
  7.                         (c) 1988 by Martin Laubach
  8.                       (c) 1989 by Maximilian Hantsch
  9.                         (c) 1989 by Martin Laubach
  10.                             All rights reserved
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.   1. Introduction    
  19.  
  20.        The idea behind this little piece of software is the use the
  21.      standard alert (also known as "guru"), to display some more
  22.      information about the program that caused the crash.  
  23.  
  24.        We used this tool (an earlier version of it) while developing
  25.      a scsi device driver -- one never knew whether it was our
  26.      wonderful code that caused the crashes, or if it was some other
  27.      malicious tool running beside it (yeah, multitasking is great).
  28.      As most people don't have a terminal connected to their machines
  29.      this program comes in handy.  
  30.  
  31.   2. Background    
  32.  
  33.        When called, it does a SetFunction() of the DisplayAlert
  34.      function of intuition.library. Each time DisplayAlert is called,
  35.      the wedge checks if someone tries to guru (it searches for "Guru
  36.      Meditation"). If not, then the alert is passed as is to the
  37.      original alert function. But when it detects a guru message, it
  38.      looks for the task address, and then computes the task name, the
  39.      program name (if the task is a CLI), the alert number and the
  40.      alert name. This is much more informative than the standard two
  41.      hex numbers.  
  42.  
  43.   3. How to   
  44.  
  45.        To install Al, just call it from the CLI prompt. Like this: 
  46.  
  47.         run al 
  48.  
  49.        The best is not yet said: Al also contains a resident tag --
  50.      that means that it can be made resident (with some utility like
  51.      RamKick) to survive even severe system failures. As soon as the
  52.      system then comes up again, it will install itself as described
  53.      above. This installation happens before(!) any guru can be
  54.      displayed. That means that with al resident, you can have the
  55.      benefit of a detailed crash description even on severe errors.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.      How to
  63.  
  64.  
  65.      Page 2                    Alert Manager                    Page 2
  66.  
  67.  
  68.   4. Example    
  69.  
  70.        I see little use in describing what Al does. Just try it this: 
  71.  
  72.              run al 
  73.              crash3 
  74.  
  75.        Then select "Cancel" on the "Task Held" requester, and lo! 
  76.  
  77.  
  78.   5. Reactions    
  79.  
  80.        If you have any comments, ideas what could be improved, bug
  81.      reports or just like to chat a bit, please feel free to contact
  82.      us at one of the following addresses...  
  83.  
  84.        Martin Laubach 
  85.  
  86.          FidoNet 2:310/3.14 
  87.          Usenet  mjl@alison.at 
  88.                  ..!uunet!mcvax!tuvie!alison!mjl 
  89.  
  90.      Or 
  91.  
  92.        Maximilian Hantsch 
  93.  
  94.          FidoNet 2:310/3.24 
  95.          Usenet  max@madvie.at 
  96.                  ..!uunet!mcvax!tuvie!madvie!max 
  97.  
  98.  
  99.        Looking forward to reading from you, 
  100.  
  101.              mjl 
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.      Reactions
  125.  
  126.  
  127.      Page 3                    Alert Manager                    Page 3
  128.  
  129.  
  130.   6. Road Map  
  131.  
  132.  
  133.  
  134.         1. Introduction   ......................................    1
  135.         2. Background   ........................................    1
  136.         3. How to  .............................................    1
  137.         4. Example   ...........................................    1
  138.         5. Reactions   .........................................    2
  139.         6. Road Map  ...........................................    3
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.      Road Map
  187.  
  188.