DaemonLost class

The DaemonLost exception class indicates that a daemon thread associated with a daemon object was lost, most probably because of a user restart.

The Run function of the Daemon system class is an example of a system method that automatically throws a DaemonLost exception.

Examples

1. The following example shows a "Try and Catch" of a DaemonLost exception. The daemon request is contrived to produce a user restart to demonstrate DaemonLost exception output:

   begin %dmn is object daemon %sl is object stringList %daemonLost is object daemonLost %dmn = new %sl = new text to %sl begin print 'Rosebud' end begin end text try %dmn:run(%sl) catch daemonLost to %daemonLost printText Daemon died! Its last words were: %daemonLost:daemonOutput:print end try end

   The result of the preceding request shows the daemon output that was stored in the exception:

   Daemon died! Its last words were: ROSEBUD

   Note: It is necessary to declare the exception object in the main thread of the program, but instantiating it is taken care of by the Run Daemon method.

2. A request cancellation does not cause the daemon thread to go away, so it does not produce a DaemonLost exception. Consequently, using the error count on the last command may be an adequate way for your application to check for a request cancellation:

   begin %dmn is object daemon %prog is object stringlist %dmn = new %prog = new text to %prog begin assert 1 eq 2 end end text try %dmn:run(%prog) if %dmn:lastCommandErrorCount then print 'Error in daemon!' end if catch daemonLost printText Caught a DaemonLost. end try end

3. To produce a DaemonLost exception for a user-created method, you would issue a User Language Language Throw statement from within the method, and you must catch it in the code that called the method. Because this exception is tailored to daemon execution by the system Run method, you are not likely to throw it from a user method, unless you want the method to Catach and then Throw the exception to the code that called the method. For example, your method might contain code like this:

   %dLost is object daemonLost try %dmn:run(%whatever) catch daemonLost to %dlost throw %dlost end try

   And the code that calls the method might contain:

   %daemLost is object daemonLost try %obj:mymethod catch daemonLost to %daemLost printText Daemon lost! %daemLost:daemonOutput:print end try

See Also

• For information about catching a thrown exception, see "Try and Catch".
• The methods in this class are listed at "List of DaemonLost methods".