\input amigatexinfo \input texinfo @c -*-texinfo-*- @setfilename DaLastAlert3.guide @settitle DaLastAlert 3 manual @c "$VER: DaLastAlert 3.0d (22.12.96)" @titlepage @title DaLastAlert 3 @center Documentation for DaLastAlert 3 @author Written by Jørgen 'Da' Larsen. Freely distributable. @page @end titlepage @ifinfo @node Top @top @center DaLastAlert 3 User Manual @center Copyright @copyright{} 1995 Jørgen 'Da' Larsen (Posse Pro. DK) @menu * Introduction:: * Copyright:: * Disclaimer:: * System Requirements:: * Installation:: * Usage:: * Bugs:: * Program History:: * About:: * What AS wrote about LA2:: @end menu @end ifinfo @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @node Introduction @chapter DaLastAlert 3 @section Introduction @c -------------------------------------------------------------------------- Are you tired of always having troubles with finding your pen and paper just to write down the last guru you got? Now this problem is solved because I have written a 'small' and quick program that will show not only the last guru, but also a nice hint to what caused it! If you don't get the point of what this program can be used to then try to read the section @ref{What AS wrote about LA2}. @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @node Copyright @section Copyright @c -------------------------------------------------------------------------- This utility is released as FREEWARE. This means that the program, and this user manual etc. (the distribution) are freely distributable, but are also Copyright (c) Jørgen 'Da' Larsen. The distribution must be kept together and there must only be charged a nominal fee to cover time and copying costs. Please also remember that no commercial usage is permitted without written permission from the author. @c -------------------------------------------------------------------------- @noindent The distribution consists of: @display * DaLastAlert3 - Main program * DaLastAlert3.info - Icon * DaLastAlert3-Check - Starter program * DaLastAlert3-Check.info - Icon * DaLastAlert3.alerts - Alerts (textfile) * DaLastAlert3.guide - Documentation in AmigaGuide© format * DaLastAlert3.guide.info - Icon * DaLastAlert3.texinfo - Documentation in TeXinfo format * DaLastAlert3.texinfo.info - Icon * DaLastAlert3.doc - Documentation in ASCII format * DaLastAlert3.doc.info - Icon * DLA3.pic - Example Picture * DLA3.pic.info - Icon * Install-script - Installer script * Install.info - Installer icon @end display @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @node Disclaimer @section Disclaimer The author is in no way liable for any changes made to any part of the package, or consequences thereof as he is in no way liable for damages or loss of data directly or indirectly caused by this software. @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @node System Requirements @section System Requirements @c -------------------------------------------------------------------------- DaLastAlert 3 requires Kickstart and Workbench 2.0 or higher to run! @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @node Installation @section Installation @c -------------------------------------------------------------------------- @noindent Just press the installer icon: @itemize @item Install @end itemize Please notice that the program can be installed anywhere you want, but please read @ref{Usage} if you want my opinion (This is also the default in the chosen installer scripts) where DaLastAlert 3 would have it's best place. @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @node Usage @section Usage @c -------------------------------------------------------------------------- @subheading DaLastAlert3 The program can either be started from Workbench (just click the icon) or from CLI/Shell with the command: @display DaLastAlert3 [G=GURUNUMBER] [H=HELP/S] [N=NOGUI/S] Examples: > DaLastAlert3 > Will popup - see picture below or > DaLastAlert3 $80000005 > Will popup as above and show the below just in a juicy GUI or > DaLastAlert3 $80000005 NOGUI > DaLastAlert v3.0d (c) 1996 Jørgen 'Da' Larsen (Posse Pro. DK) > Alert Number: $80000005 > Alert Task: Unknown > Alert Name: ACPU_DivZero > Spec. Alert: Divide by zero > Spec. Error: Hardware/CPU or > DaLastAlert3 HELP > DaLastAlert v3.0d (c) 1996 Jørgen 'Da' Larsen (Posse Pro. DK) > Syntax: DaLastAlert [G=GURU] [N=NOGUI] [H=HELP] > Try: DaLastAlert $80000004 > or DaLastAlert $80000004 NOGUI +------------------------------------------------------------+ | | DaLastAlert 3 | | +------------------------------------------------------------+ | | | Alert Number : 0x80000005 | | Alert Task : 0x0800DDE8 | | ------------------------------------------------------- | | Alert Name : ACPUG_DivZero | | Spec. Alert : Hardware/CPU | | Spec. Error : Divide by zero | | | |------------------------------------------------------------| | _________________________________________ | | Alert Number : |_________________________________________| | -+ | | | |------------------------------------------------------------| | | | | | About Last alert Quit | | | | | +------------------------------------------------------------+ | | | | | | | | | Show ---+ Shows the ---+ Quit!---+ Input ---+ about last alert string requester again @end display DaLastAlert3 also reads ENV:DaLastAlert that tells DaLastAlert3 where look for the textfile that contains the alert descriptions (Default: 'S:DaLastAlert3.alert'). @subheading Note The alert number shown by pressing 'Last alert' will of course be meaningless if you haven't had any Software failure's since you turned your system on. @c -------------------------------------------------------------------------- @subheading DaLastAlert-Check If you can't get a postive reaction from DaLastAlert-Check it's probably because you haven't had a Guru/Software failure lately. If you have had a Guru/Software failure then the string defined as EXEC will be executed. The program can either be started from Workbench (just click the icon) or from CLI/Shell. The options are as follows: @display WB Options EXEC - Where to find DaLastAlert3 Example: > EXEC=sys:Utilities/DaLastAlert3 (This is also the default) CLI Options DaLastAlert3-Check [EXEC] Examples: > DaLastAlert3-Check > Executes sys:Utilities/DaLastAlert3 or > DaLastAlert3-Check c:DaLastAlert3 > Executes c:DaLastAlert3 @end display @c -------------------------------------------------------------------------- My suggestion to make DaLastAlert 3 as efficient as possible will be to place DaLastAlert3-Check in the WBStartup drawer (or maybe in the Startup-sequence) as this will allow you to recieve information on the last guru. If you follow my suggestion you will be free from troubles, like where's my pen and I am out of paper, every time a guru pops up. @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @node Bugs @section Bugs @c -------------------------------------------------------------------------- DaLastAlert 3 have been tested on these configurations: @vtable @code @item Amiga 2000 A2000, GVP G-Force 030 50MHz, MMU, FPU @item Amiga 1200 2 MB CHIP. @item Amiga 1200 MBX1200Z, 2 MB CHIP, 4 MB FAST. @item Amiga 1200 BLIZZARD 1220/4 28.5MHz, NO FPU, 2 MB CHIP, 4 MB FAST. @item Amiga 1200 M1230XA 40MHz, NO MMU, NO FPU, 2 MB CHIP, 8 MB FAST, Overdrive HD. @item Amiga 1200 M1230XA 50MHz, MMU, FPU, 2 MB CHIP, 8 MB FAST, EzDrive, CD-Rom (My Amiga). @end vtable I cannot find any (more) bugs in DaLastAlert 3 but i am sure you can. If you find a bug PLEASE fillout the bugreport formular below (orginal made by Dave Haynie) and send it to me (see @ref{About} for address). @subheading Bugreport @display Your Configuration: [] A500 []A1000 []A2500 []A1200 []CDTV/CD32 [] A600 []A2000 []A3000 []A4000 []Other KS Version___________ RAM__________ Other HW__________________ WB Version___________ HD___________ HD Controller_____________ Please explain the problem as completely as possible: File System Version/Type__________________________________________ ScreenMode________________________ Font__________________________ []Shell/CLI []Workbench Locale________________________ Problem: []Full Lockup []GURU/Crash Steps to see this problem?________________________________________ __________________________________________________________________ __________________________________________________________________ Other Comments____________________________________________________ __________________________________________________________________ __________________________________________________________________ Bug found by (address)____________________________________________ __________________________________________________________________ __________________________________________________________________ @end display @subheading Note If you have Enforcer active while running DaLastAlert 3 you will get some 'Enforcer Hits' because DaLastAlert 3 makes LONG-READs at $100 and $104.( This is no BUG :P ). @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @node Program History @section Program History @c -------------------------------------------------------------------------- @subheading Version 1.0 @itemize @item First release. (And it works on Kickstart and Workbench 3.0) @item Only tested on a A1200 with different configurations with Kickstart and Workbench 3.0 @end itemize @c -------------------------------------------------------------------------- @subheading Version 2.0 @itemize @item Now LastAlert also shows: Alert Number, Alert Task, Alert Name, Spec. Alert, Spec. Error. @item Still not tested on a Kickstart and Workbench 2.0 system! @end itemize @subheading Version 2.1 @itemize @item First public release (Aminet). @item A little bug fixed !!! @end itemize @c -------------------------------------------------------------------------- @subheading Version 3.0a @itemize @item Only released to two ßetatesters. @end itemize @itemize @item Changed the name from LastAlert to DaLastAlert. @item Totally rewritten code (Now using Amiga E by Wouter van Oortmerssen). @item Now two programs. @itemize @item A small starter program (DaLastAlert3-Check). @item A 'big' main program (DaLastAlert3). @end itemize @item Now with a totally cool GUI (EasyGUI - Wouter van Oortmerssen). @itemize @item Totally Font-Sensitive. @item Resizable. @item Etc. @end itemize @item And loads of other stuff.... @end itemize @c -------------------------------------------------------------------------- @subheading Version 3.0b @itemize @item Added an alert file (S:DaLastAlert3.alerts). @item Added an environment var. (ENV:DaLastAlert3). @item Cleanedup source code. @item Made Error-handling better (PrintF->EzReq). @item Minor GUI design error corrected (COLS->EQCOLS). @item Added requester titles. @item Changed About text. @end itemize @subheading Version 3.0c @itemize @item First Public Release of DaLastAlert 3 (Aminet). @end itemize @subheading Version 3.0d @itemize @item Second Public Release of DaLastAlert 3 (Aminet). @item Updated the GUI and the GUI-Handling (EasyGUI v3.3a.1) @end itemize @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @node About @section About @c -------------------------------------------------------------------------- @subheading Address If you want to contact the author of this program then write to this address: @display Mail: Jørgen 'Da' Larsen (Posse Pro. DK) Ryesgade 57, 3.TH 9000 Aalborg Denmark E-mail: dapp@@cs.auc.dk @end display @noindent Or try my WWW-Homepage: @display URL: http://www.cs.auc.dk/~dapp/ @end display @c -------------------------------------------------------------------------- @subheading Note Please write if you have some remarks, suggestions or if you have found some @ref{bugs} in the program (you are also welcome to send me a modem, bike, car, house or maybe just a note saying that you like the program). @c -------------------------------------------------------------------------- @subheading Credits @vtable @code @item Søren Staun-Pedersen ßetatester. @item Claus Nyhus Chr. ßetatester @item Anders F. ßetatester @item Wouter van Oortmerssen Amiga E, EDBG, EasyGUI.... @end vtable @c -------------------------------------------------------------------------- @subheading Greetings ( Randomized ) @itemize @item Søren Staun-Pedersen - No 'REAL' computer!! @item Claus Nyhus Chr. - Get E'ing @item Anders S. Elkjær - NO computer ehh!! @item Anders F. - I am waiting for the MegaDemo II @item Mogens C. Larsen - Amiga Power!!!!! @item Flemming Kjær Jensen - Always the MAC @item Frank 'Dux' Busborg - Amosazing @item Jens K. Jensen - Party on .. @item Esben S. Omething - Hello!! @item Yeko - Hold the line!! @item Frostie - JOE 'Tekkno Sumpen' @item Preben Nielsen - What a cruel asm coder!! @item Bent D. Olsen - Thanks for your letter @item Amiga Shopper - Great inspiration, testing LA2 @item +ALL AMIGA OWNERS @end itemize @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @c -------------------------------------------------------------------------- @node What AS wrote about LA2 @section What Amiga Shopper wrote about LastAlert2 @c -------------------------------------------------------------------------- Amiga Shopper wrote the following about LastAlert2 in issue 46 (February 1995): @center ----------- @noindent From Subscripers coverdisk description: ``LastAlert2 is very useful utility indeed. It will tell you the Guru number of your machine after it has crashed. Once the folder has been unarchived double-click on the install icon and the files will be copied to the appropriate directories. By default LastAlert2 will be copied to your WBStartup drawer. This means that if you machine crashes the program will be run as soon as the machine resets. It will produce a requester that informs of number the offending Guru.'' @center ----------- @noindent From inside the magazine on page 78: ``If there is one thing that is guaranteed to turn even the most sane Amiga-user into to an irrational, salivating wild beast it's a system crash. When this happens it's a good idea to make a note of the guru number that is flashed on screen. Unfortunately the average human is unlikely to be in a state of mind that will facilitate the execution of such a complex action. During these moments of debilitating rage you will certainly benefit from a program like LastAlert2. LastAlert2 is a Wb2+ program that will record the last message displayed by you machine. This will give you the opportunity to take note of this number while you are in a more... chemically balanced state-of-mind.'' @contents @bye