Changes between Version 2 and Version 3 of WorkGeneration

Timestamp:

Apr 18, 2007, 4:05:30 PM (17 years ago)

Author:

davea

Comment:

--

WorkGeneration

@@ +1 @@
+[[PageOutline]]
 = Generating work =
 
-As described earlier, a workunit represents the inputs to a computation. The steps in creating a workunit are:
-
-    * Write XML 'template files' that describe the workunit and its corresponding results. Generally the same templates will be used for a large number work of workunits.
-    * Create the workunit's input file(s) and place them in the download directory.
-    * Invoke a BOINC function or script that creates a database record for the workunit. 
-
-Once this is done, BOINC takes over: it creates one or more results for the workunit, distributes them to client hosts, collects the output files, finds a canonical result, assimilates the canonical result, and deletes files.
+To submit a job:
+
+    * Write XML 'template files' that describe the job's input and outputs (typically the same template files will be used for many jobs).
+    * Create the job's input file(s) in the download directory.
+    * Invoke a BOINC function or script that submits the job.
+
+Once this is done, BOINC takes over: it creates one or more instances of the job, distributes them to client hosts, collects the output files, finds a canonical instance, assimilates the canonical instance, and deletes files.
 
 During the testing phase of a project, you can use the [http://boinc.berkeley.edu/busy_work.php make_work daemon] to replicate a given workunit as needed to maintain a constant supply of work. This is useful while testing and debugging the application.
 
-== Workunit and result template files ==
-
-A workunit template file has the form
+== Input and output template files ==
+
+An input template file has the form
 {{{
 <file_info>
@@ -54 +55 @@
         The amount of credit to be granted for successful completion of this workunit. Use this only if you know in advance how many FLOPs it will take. Your [http://boinc.berkeley.edu/validate_simple.php validator] must use get_credit_from_wu() as its compute_granted_credit() function.
 
-Other elements::
-        Work unit attributes
+ Other elements::
+        [http://boinc.berkeley.edu/work.php Work unit attributes]
 
 Workunit database records include a field, 'xml_doc', that is an XML-format description of the workunit's input files. This is derived from the workunit template as follows:
@@ -62 +63 @@
     * Within a <file_ref> element, <file_number>x</file_number> is replaced with an element giving the filename. 
 
-A result template file has the form
+An output template file has the form
 {{{
 <file_info>