@database patchalert 1.0 # version : patchalert.guide 1.0 © C.Beskow - Cub Arts Software - 1994 @node main "PatchAlert 1.0 Guide" @next about Press the different gadgets to inform yourself about this program ! @{"About this software " LINK about} @{"Disclaimer " LINK disclaimer} @{"Copyrights " LINK copyrights} @{"Requirements " LINK requirements} @{"CLI/SHELL usage " LINK cli} @{"Workbench usage " LINK wb} @{"If activated " LINK active} @{"Distribution information " LINK distribute} @{"Test configurations " LINK test} @{"Bugs " LINK bugs} @{"History " LINK history} @{"Future " LINK future} @{"Comments " LINK comments} @{"My address " LINK address} @{"Thanks " LINK thanks} READ THE @{"DISCLAIMER" LINK disclaimer} BEFORE YOU RUN @{"PATCHALERT" LINK nodepatchalert}! @endnode @node about "About this software" @prev main @toc main @next disclaimer If you've been using your Amiga for a while, you can't have missed the Guru Meditation - SoftWare Failure requester. When a program, for example, tries to free a memoryblock more than once, you'll get several $01000005- alerts, and after a while a @{"DEAD END" link deadend} alert. This force the machine to reboot, and you feel that you can throw your piece of garbage through the window, 'cause 4 hours of work is lost in a nano-second... Here, @{"PatchAlert" LINK nodepatchalert} makes your day! By patching the @{"Alert" LINK alert}() function in exec.library, you'll be able to remove the task who failed, view the alert or try to continue. Some Viruscheckers may protest and say that vector -108 (or -$6c) in exec.library is infected by some unknown virus. This 'virus' is @{"PatchAlert" LINK nodepatchalert}, so don't worry! @{"PatchAlert" LINK nodepatchalert} is FREEWARE, so you can use it and copy it as long as the archive remains unchanged. No costs except for disks, copying and distribution may be charged. If you're going to distribute @{"PatchAlert" LINK nodepatchalert} in any way (except for aminet) please let me now. Donations are welcome, but not needed. If you like this software, please let me know. @endnode @node Disclaimer @prev about @toc main @next copyrights Once you've installed @{"PatchAlert" LINK nodepatchalert}, the responsibility is all yours. @{"PatchAlert" LINK nodepatchalert} is distributed with no special purpose, and in no way can the author be held responsible for any damage caused by the use or misuse of this program. No warranty is granted in any way by C.Beskow or Cub Arts Software. @endnode @node Copyrights @prev Disclaimer @toc main @next requirements Amiga and everything associated with this computer is © Commodore-Amiga Inc @{"PatchAlert" LINK nodepatchalert} and its code is © C.Beskow - Cub Arts Software - 1994. You may not disassemble the code and/or change it in any way. @endnode @node Requirements @prev Copyrights @toc main @next cli You need one or more Amiga(s) to run this software :) , and OS2.0 or higher. You also need at least 2kB of free memory. @{"PatchAlert" LINK nodepatchalert} won't work on preOS2.0machines, so you better upgrade if you're still sitting on KS1.3... KS1.2/1.3-version may come in the future.. (see @{"Future" LINK future} for more details!) @endnode @node cli "CLI/SHELL usage" @prev Requirements @toc main @next wb If you start @{"PatchAlert" LINK nodepatchalert} form the CLI/SHELL, you've got 3 different options. 1. @{"PatchAlert" LINK nodepatchalert} This will activate/deactivate @{"PatchAlert" LINK nodepatchalert}. If you're running @{"PatchAlert" LINK nodepatchalert} for the first time, the @{"Installed" system "display pics/installedreq.iff"} requester will appears. When started a second time, @{"PatchAlert" LINK nodepatchalert} removes itself, and displays the @{"Removed" system " display pics/removedreq.iff"} requester. 2. @{"PatchAlert" LINK nodepatchalert} NOREQ This work as @{"PatchAlert" LINK nodepatchalert} , but no requesters will be displayed. This function is good if you put the program in S:user-startup. 3. @{"PatchAlert" LINK nodepatchalert} INFO This will display some information. If patchalert is installed, the @{"Information" system "display pics/informationreq.iff"} requester will display where in the memory that the patch is located. @endnode @node wb "Workbench Usage" @prev cli @toc main @next active The tooltypes supported is the same as the supported @{"CLI/SHELL" LINK cli} arguments. If you place @{"PatchAlert" LINK nodepatchalert} in your WBStartup-drawer, and set the tooltype to NOREQ, @{"PatchAlert" LINK nodepatchalert} will then perform a silent start. You can also set the tooltype to INFO, which will display the @{"Information" system "display pics/informationreq.iff"} requester for you. Only the first tooltype will be used. There's no use to have INFO and NREQ at the same time, as nothing will happen then... :) If no tooltypes is set, @{"PatchAlert" LINK nodepatchalert} will then behave like this: If you want to Install/Remove @{"PatchAlert" LINK nodepatchalert} via Workbench, so is this very easy to do :) . Just double-click on the icon for @{"PatchAlert" LINK nodepatchalert}. If @{"PatchAlert" LINK nodepatchalert} isn't already installed, the @{"Install" system "display pics/installedreq.iff"} requester will pop up. Otherwise, you'll see the @{"Removed" system "display pics/removedreq.iff"} requester. @endnode @node active "If activated.." @prev wb @toc main @next distribute If a @{"DEAD END" LINK deadend} alert occurs, sometimes the @{"Software Failure" system "display pics/softfailure.iff"} requester pops up. Pressing the reboot-gadget will then invoke @{"PatchAlert" LINK nodepatchalert} as described below (if it's installed..) If a program fails, and performs an @{"Alert" LINK alert}(), the @{"PatchAlert AlertRequester" system "display pics/alertreq.iff"} pops up and leaves three options: Perform @{"Alert" LINK alert} Remove Task Continue Task If you want to view the Guru-Meditation requester, so press Perform @{"Alert" LINK alert}. If the alert is a @{"DEAD END" LINK deadend} alert, then this may reboot the machine. Remove Task removes the failing program from the tasklist. If the program have any screens or windows open, they'll remain open. Continue Task performs the next instruction to be executed. This may result in another alert or crash! @endnode @node distribute "Distribution" @prev active @toc main @next test If you're going to put this program on a compilation in any form, then the archive MUST contain the following UNCHANGED files: @{"PatchAlert" LINK nodepatchalert} 2336 bytes - the main program @{"PatchAlert" LINK nodepatchalert}.info 465 bytes - its icon @{"PatchAlert" LINK nodepatchalert}.guide 11112 bytes - this document @{"PatchAlert" LINK nodepatchalert}.guide.info 855 bytes - my icon 1.xusers.readme 94 bytes - textfile for pre2.0users pics/@{"alertreq.iff" system "display pics/alertreq.iff"} 2680 bytes - example picture pics/@{"informationreq.iff" system "display pics/informationreq.iff"} 8224 bytes - example picture pics/@{"installedreq.iff" system "display pics/installedreq.iff"} 2010 bytes - example picture pics/@{"removedreq.iff" system "display pics/removedreq.iff"} 1730 bytes - example picture pics/@{"softfailure.iff" system "display pics/softfailure.iff"} 2380 bytes - example picture If you're going to place @{"PatchAlert" LINK nodepatchalert} on any compilation etc. , please let me know! (exceptions : Aminet ) THIS PROGRAM MAY NOT BE SOLD! THIS IS A 100% FREEWARE PROGRAM!! @endnode @node test "Test configurations:" @prev distribute @toc main @next bugs @{"PatchAlert" LINK nodepatchalert} have been successfully tested on the following configuration(s): Amiga 2000C equipped with 52 MB SCSI HD 2 MB FASTMEM 1 MB CHIPMEM 2 DD-DRIVES PLAIN 68000 CPU If you've got a different configuration, and excellent :) results, please let me know! Thanks in advance.. @endnode @node bugs "Known Bugs:" @prev test @toc main @next history Known bugs: Some DEAD END alerts isn't recognised. They still force the machine to reboot. :( No other bugs known. @endnode @node History @prev bugs @toc main @next future @{"PatchAlert" LINK nodepatchalert} 1.0 (27-05-94) First release. Bugs: See @{"Known bugs" LINK bugs} @endnode @node Future @prev History @toc main @next comments Bug mentioned in @{"Known bugs" link bugs} will be removed :) New Options: - Windows and screens opened by removed program will be closed @endnode @node Comments @prev Future @toc main @next address As english isn't my first language, this document may contain several grammatical mistakes.... Sorry.. @endnode @node Address @prev Comments @toc main @next thanks If you want to contact me for some reason, feel free to do it with... E-Mail : el9203@utb1.inh.hb.se SnailMail : C.Beskow - @{"PatchAlert" LINK nodepatchalert} Skomakarevägen 9 S-510 10 Horred SWEDEN N.B. The E-mail address is active until JUNE 1995 @endnode @node Thanks @prev Address @toc main Thanks to (in no special order) F.Fridmar - Enchantments on my A2000 Gunther Nikl - Help Sandra - Sleeping site Jörgen - Transports F242 - Never Stop! FLA - No Limit (NOT 2 (un)limited) Kollberg - Siel Opera 6 Stephen King - the books Skivhugget - cheap CD:s Åbro - XPP the inventor of MIDI - I'm connected! S.P.O.C.K. - everything Big B - advices IBM - the Important Bullshit Machines :) Motorola - 680x0 DM - Violator Mats - more Transports Pernilla - healing Nina - the umbrella Goff - Gnuff Mr.Bean - Both of u! You - You're using my software!! and the rest who I forgot.... @endnode @node deadend "DEAD END" @toc main A DEAD END alert occurs when your Amiga crashes as deep as possible. The only way to solve this problem is to reboot... Example of a DEAD END alert: $81000005 @endnode @node Alert @toc main Alert is an exec.library function with offset -108 (DEC) -$6c (HEX) @endnode @node nodepatchalert "PatchAlert" @toc main PatchAlert is the SOFTWARE you're reading about..... @endnode @node Denna är tom @endnode