Exceptions

AttemptRecovery BootAttemptRecovery CatchByClass CatchException CheckLowMemoryOften CheckLowOnMemory CheckOutOfMemory CheckPendingLowOnMemory CheckRecovery Commit

Fail RecoverAfter RecoverFrom ReportLowOnMemory ReportLowOnMemoryOften ReportOutOfMemoryAndRebootIfNeeded SetCanFailWithoutRevert Try Warn

Attributes

Class Exceptions defines no new attributes.

Fields

instance Exceptions tag;
end instance;

Define Class Exceptions;
    inherits from Object;

    intrinsic Try(): Object;                        
        // returns nilObject, or an exception object
    intrinsic CatchException(match: Object): Object;
        // returns nilObject, or an exception object; skipped if no match
    intrinsic CatchByClass(matchClassNumber: ClassNumber): Object;
        // returns nilObject, or an exception object; skipped if no match
    intrinsic Commit();                             
        // call when the operation we tried succeeded

    intrinsic Fail(exception: Object);              
        // the operation this call is in failed
    intrinsic Warn(exception: Object);                  
        // failed, but only if someone cares

    intrinsic RecoverFrom(exception: Object): Object;
        // default UI for handling highest level try
    intrinsic RecoverAfter(exception: Object; reason: Unsigned): Object;
        // delayed version of the above, after reboot
    intrinsic CheckRecovery();                          
        // see if we can get memory back or tell user otherwise
    intrinsic AttemptRecovery(): Boolean;               
        // tell system to make a try at getting out of memory again
    intrinsic BootAttemptRecovery(): Boolean;
        // same as AttemptRecovery, except will put up a warning if 
        // did not recover from low on memory about packages being packed up
        // called only from the begining of UserActor_Main
    intrinsic SetCanFailWithoutRevert(newSetting: Boolean): Boolean;
        // allows sections of code where a failing due to low-memory can fail (everything is consistent)

    // private calls for exception handlers

    intrinsic ReportLowOnMemory(again: Boolean);
        // bring up the low on memory window
    intrinsic ReportLowOnMemoryOften();
        // if long past the last time the user was notified and still low, bring up the low on
        // memory window again
    intrinsic ReportOutOfMemoryAndRebootIfNeeded();
        // if rebooting for out of memory, bring up the out of memory window and build
        // purging list, else bring up window and reboot
        
    intrinsic CheckLowMemoryOften();
        // check if any containers pending low on memory and handle pending low on
        // memory if needed; called periodically
    intrinsic CheckLowOnMemory(): Boolean;
        // returns true if any container low on memory
    intrinsic CheckPendingLowOnMemory(): Boolean;
        // returns true if any container pending low on memory
    intrinsic CheckOutOfMemory(): Boolean;
        // returns true if any container out of memory
    
end class;