[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   NAME
        Alert -- alert the user of an error

   SYNOPSIS
        Alert(alertNum)
              D7

        void Alert(ULONG);

   FUNCTION
        Alerts the user of a serious system problem.  This function will
        bring the system to a grinding halt, and do whatever is necessary
        to present the user with a message stating what happened.
        Interrupts are disabled, and an attempt to post the alert is made.
        If that fails, the system is reset.  When the system comes up
        again, Exec notices the cause of the failure and tries again to
        post the alert.

        If the Alert is a recoverable type, this call MAY return.

        This call may be made at any time, including interrupts.
        (Well, only in interrupts if it is non-recoverable)

        New, for V39:
        The alert now times out based on the value in LastAlert[3]
        This value is transfered accross warm-reboots and thus will let
        you set it once.  The value is the number of frames that need to
        be displayed before the alert is auto-answered.  A value of
        0 will thus make the alert never be displayed.  Note that
        it is recommended that applications *NOT* change the value in
        LastAlert[] since the main reason for this is to make
        unattended operation of the Amiga (in production enviroments)
        possible.

   POST-MORTEM DIAGNOSIS
        There are several options for determining the cause of a crash.
        Descriptions of each alert number can be found in the "alerts.h"
        include file.

        A remote terminal can be attached to the Amiga's first built-in
        serial port.  Set the communication parameters to 9600 baud, 8 bits,
        no parity.  Before resetting the machine, the Alert function will
        blink the power LED 10 times.  While the power indicator is flashing,
        pressing DELETE on the remote terminal will invoke the ROM debugger.

   INPUT
        alertNum   - a number indicating the particular alert.  -1 is
                     not a valid input.

   NOTE
        Much more needs to be said about this function and its implications.

   SEE ALSO
        exec/alerts.h