Changes between Version 24 and Version 25 of WorkGeneration

Timestamp:

Mar 24, 2009, 11:19:40 AM (17 years ago)

Author:

davea

Comment:

--

WorkGeneration

@@ -77 +77 @@
 
 Elements and tags must be on separate lines as shown.
-The components are:
-
- <file_info>, <file_ref>::
-
-        Each pair describes an [BoincFiles#Fileproperties output file] and [BoincFiles#Filereferences the way it's referenced].
-
-Note: when a job is created, the name of its output template file is stored.
+Each <file_info>, <file_ref> pair describes an output file.
+The elements include:
+ '''<name>''' and '''<file_name>''':: the physical file name.  Typically use <OUTFILE_0>, <OUTFILE_1> etc.; this will be replaced with a generated name based on the job name.
+ '''<generated_locally/>''':: always include this for output files.
+ '''<max_nbytes>''':: maximum file size.  If the actual size exceeds this, the file will not be uploaded, and the job will be marked as an error.
+ '''<url>''':: the URL of the file upload handler.  You may include this explicitly, or use '''<UPLOAD_URL/>''' to use the URL in your project's config.xml file.
+ '''<open_name>''':: the "logical name" by which your application will reference the file.
+ '''<optional>''':: if false, your application must create the file, otherwise the job will be marked as an error.
+ '''<no_validate>''':: if true, don't include this file in the result validation process (relevant only if you are using the sample bitwise validator).
+
+Other [BoincFiles#Fileproperties output file] and [BoincFiles#Filereferences the way it's referenced].
+
+Note: when a job is created, the name of its output template file is stored in the database.
 The file is read when instances of the job are created, which may happen days or weeks later.
 Thus, editing an output template file can affect existing jobs.