2002-08-20 23:54:17 +00:00
|
|
|
<title>Results</title>
|
|
|
|
|
<body bgcolor=ffffff>
|
|
|
|
|
<h2>Results</h2>
|
2002-05-17 22:33:57 +00:00
|
|
|
<p>
|
2003-08-15 22:19:25 +00:00
|
|
|
A <b>result</b> describes an instance of a computation, either unstarted,
|
|
|
|
|
in progress, or completed.
|
2002-08-19 18:43:10 +00:00
|
|
|
The attributes of a result include:
|
2002-07-15 05:34:32 +00:00
|
|
|
|
2003-08-15 22:19:25 +00:00
|
|
|
<dl>
|
|
|
|
|
<dt><b>name</b><dd>
|
|
|
|
|
The name of the result (unique across all results in the project).
|
|
|
|
|
<dt><b>workunit name</b><dd>
|
|
|
|
|
<dt><b>output files</b><dd>
|
|
|
|
|
A list of the names of the output files,
|
|
|
|
|
and the names by which the application refers to them.
|
|
|
|
|
<dt><b>state</b><dd>
|
|
|
|
|
Values include:
|
2002-05-17 22:33:57 +00:00
|
|
|
<ul>
|
2002-08-19 18:43:10 +00:00
|
|
|
<li> Inactive (not ready to dispatch)
|
|
|
|
|
<li> Unsent (ready to dispatch, but not dispatched)
|
|
|
|
|
<li> In progress (dispatched, not done)
|
|
|
|
|
<li> Done successfully
|
|
|
|
|
<li> Timed out
|
|
|
|
|
<li> Done with error
|
2002-05-17 22:33:57 +00:00
|
|
|
</ul>
|
2003-08-15 22:19:25 +00:00
|
|
|
<dt><b>host</b><dd>
|
|
|
|
|
The host that executed the computation.
|
|
|
|
|
<dt><b>CPU time</b><dd>
|
|
|
|
|
The CPU time that was used.
|
|
|
|
|
<dt><b>exit status</b><dd>
|
|
|
|
|
</dl>
|
2002-08-21 23:49:33 +00:00
|
|
|
<p>
|
2002-11-07 19:31:34 +00:00
|
|
|
The following attributes are defined after the result is completed:
|
|
|
|
|
<ul>
|
|
|
|
|
<li> An XML document giving the sizes and checksums of its output
|
|
|
|
|
files (filled in after the result is completed).
|
|
|
|
|
<li> The stderr output of the result.
|
|
|
|
|
<li> The host that was sent the result.
|
|
|
|
|
<li> The times when the result was received.
|
|
|
|
|
</ul>
|
|
|
|
|
<p>
|
2002-08-21 23:49:33 +00:00
|
|
|
Results are normally created using the
|
|
|
|
|
<a href=tools_work.html>create_work</a> utility.
|
|
|
|
|
<p>
|
2002-07-29 19:01:38 +00:00
|
|
|
The XML document listing the output files has the form: <pre>
|
2002-11-07 19:31:34 +00:00
|
|
|
<file_info>...</file_info>
|
2002-05-17 22:33:57 +00:00
|
|
|
[ ... ]
|
2002-11-07 19:31:34 +00:00
|
|
|
<result>
|
|
|
|
|
<name>foobar</name>
|
|
|
|
|
<wu_name>blah</wu_name>
|
|
|
|
|
<exit_status>blah</exit_status>
|
|
|
|
|
<file_ref>...</file_ref>
|
2002-05-17 22:33:57 +00:00
|
|
|
[ ... ]
|
2002-11-07 19:31:34 +00:00
|
|
|
</result>
|
2002-08-19 18:43:10 +00:00
|
|
|
</pre>
|
|
|
|
|
The components are:
|
2002-05-17 22:33:57 +00:00
|
|
|
<ul>
|
2002-11-07 19:31:34 +00:00
|
|
|
<li> The <b><name></b> element is the result name.
|
|
|
|
|
<li> The <b><wu_name></b> element is the workunit name.
|
|
|
|
|
<li> Each <b><file_ref></b> element is an association to an
|
|
|
|
|
output file, described by a corresponding <b><file_info></b> element.
|
2002-05-17 22:33:57 +00:00
|
|
|
</ul>
|
|
|
|
|
<p>
|
2002-08-19 18:43:10 +00:00
|
|
|
The XML document describing the sizes and checksums of the output
|
2002-11-07 19:31:34 +00:00
|
|
|
files is just a list of <b><file_info></b> elements, with the
|
2002-08-19 18:43:10 +00:00
|
|
|
<b>nbytes</b> and <b>md5_cksum</b> fields present.
|
|
|
|
|
The project back end
|
|
|
|
|
must parse this field to find the locations and checksums of output files.
|
