home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 10: Diskmags / nf_archive_10.iso / MAGS / STFORMAT / STF14.MSA / NOBOMBS_NOBOMBS.DOC < prev    next >
Text File  |  1987-04-21  |  4KB  |  111 lines
  1.  
  2.  
  3.  
  4.      Program :- NOBOMBS.TOS
  5.      ----------------------
  6.  
  7.           This program,as the name suggests,stops those all  too common
  8.      bombs  that  appear in the middle of the screen,when  the  machine
  9.      crashes.Instead  it replaces the most common of these  with  their
  10.      actual  error  messages,and  the number of  bombs  that  would  of
  11.      appeared.
  12.  
  13.           This  program is what is known as a TSR ( Terminate and  Stay
  14.      Resident.)  program.So once run from either the  Desktop,the  Auto
  15.      folder  or a Command line,the program stays in memory waiting  for
  16.      an error to occur.
  17.  
  18.           Once run,the program initialises itself and prints an initial
  19.      message to tell you what the program does.To exit from this or one
  20.      of  the  error  messages,simply  press any key  and  you  will  be
  21.      returned to the calling program (e.g the DESKTOP.).
  22.  
  23.           Due  to the nature of some of the errors that  can  occur,not
  24.      all are intercepted,so that if one of these rare and usually  more
  25.      fatal errors occur,the program will crash with it's usual thud and
  26.      bomb  out.These  errors  would probably interfere  with  the  error
  27.      handler and cause a multiple crash.
  28.  
  29.      Current errors handled.
  30.      -----------------------
  31.  
  32.           Here  is  a list of the errors,which the error  handler  will
  33.      intercept:-
  34.  
  35.                +----------+-------------------------------+
  36.                | No.Bombs |   Message                     |
  37.                +----------+-------------------------------+
  38.                |    2     |   Bus error.                  |
  39.                |    3     |   Address error.              |
  40.                |    4     |   Illegal Instruction.        |
  41.                |    5     |   Division by Zero.           |
  42.                |    8     |   Privilege Violation.        |
  43.                |    9     |   Trace.                      |
  44.                |   12     |   Undocumented error.         |
  45.                |   13     |   Undocumented error.         |
  46.                |   14     |   Undocumented error.         |
  47.                |   15     |   Uninitialised interrupt.    |
  48.                |   24     |   Spurious interrupt.         |
  49.                +----------+-------------------------------+
  50.  
  51.      Postmortem Information.
  52.      -----------------------
  53.  
  54.           This    program,as   does   the   operating    system    when
  55.      crashing,produces postmortem information.This is so that once  the
  56.      program  has tried to crash,the status of the machine  before  the
  57.      crash can be found.This aids with debugging the crashed program by
  58.      allowing you to see what went wrong and where.This information can
  59.      be  viewed with a program such a 'POSTMORT.PRG'  by  M.S.Powell,as
  60.      found on the Coverdisk of ST Format No.1.
  61.  
  62.      Examples.
  63.      ---------
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.           So that you can see the program in action an example  program
  72.      is supplied.
  73.  
  74.           First,Run  the  NOBOMBS.TOS program and exit to  the  desktop
  75.      with  a  key press.Then run the DIVZERO.PRG  program.This  program
  76.      will try to do a Division by Zero,which is an error.But instead of
  77.      erroring,the  error handler will intercept this and  should  print
  78.      the message :-
  79.  
  80.                'Division by  Zero           (5 bombs)'
  81.  
  82.           A  simple  press  of any key will terminate    the    crashed
  83.      program and return you to  the  calling program ( e.g. DESKTOP).
  84.  
  85.      Compatibility.
  86.      --------------
  87.  
  88.           As far as I know,this program is compatible with all  current
  89.      versions  of TOS,that run on a 68000.Although I have  not  checked
  90.      this,the  method of implementing the errors should easily work  on
  91.      all ST's.
  92.  
  93.                               ---------------
  94.  
  95.      Anyone  interested  in  knowing more about  this  program  or  are
  96.      interested in programming (especially in BASIC,C,MACHINE CODE  and
  97.      others)or in general and wants to exchange ideas ,help,software or
  98.      tips.
  99.  
  100.      Please contact me at :-
  101.  
  102.      Mr. A.D. Messer.
  103.      'Lucerne',
  104.      Nett Rd,
  105.      Shrewton,
  106.      Salisbury,
  107.      Wiltshire.
  108.      SP3 4HB
  109.  
  110.                               ---------------
  111.