Changes between Version 2 and Version 3 of AssimilateIntro

Timestamp:

Mar 7, 2008, 11:31:28 AM (17 years ago)

Author:

davea

Comment:

--

AssimilateIntro

@@ -16 +16 @@
 It's possible that both conditions might hold.
 
-If `assimilate_handler()` returns zero, the workunit record will be marked as assimilated. If assimilate_handler() returns nonzero, the assimilator will log an error message and exit. Typically the function should return nonzero for any error condition. This way the system administrator can fix the problem before any completed or erroneous workunits are mis-handled by BOINC.
+The return values of `assimilate_handler()` are:
+ * 0: the workunit will be marked as assimilated.
+ * DEFER_ASSIMILATION: the workunit will not be marked as assimilated, and will be processed again when the next instance finishes.  This is useful for appliations where you want to see all the completed results.
+ * Other nonzero values: the assimilator will log an error message and exit. Typically the function should return nonzero for any error condition. This way the system administrator can fix the problem before any completed or erroneous workunits are mis-handled by BOINC.
 
 You can use BOINC's [BackendUtilities back-end utility functions] to get file pathnames and open files.