Changes between Version 14 and Version 15 of CondorBoinc


Ignore:
Timestamp:
Mar 6, 2013, 2:26:22 PM (12 years ago)
Author:
jfrey
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • CondorBoinc

    v14 v15  
    8181
    8282The commands are:
    83 {{{
    84 BOINC_SUBMIT <req id> <batch name> <app name> <#jobs>
    85   <job name> <#args> <arg1> <arg2> ...
    86   <#input files>
    87     <src path> <dst filename>
     83
     84Submit a new job batch:
     85{{{
     86BOINC_SUBMIT <req id> <batch name> <app name>
     87  <#jobs>
     88    <job name> <#args> <arg1> <arg2> ...
     89    <#input files>
     90      <src path> <dst filename>
     91      ...
    8892    ...
    8993  ALL|<#output files>
    9094    <filename> ...
    91   ...
    9295Result:
    9396  NULL (success) or <err msg>
     
    9598Notes:
    9699 * The batch name must be unique over all submissions
    97  * The output file descriptions are optional;
    98    in any case, they must agree with the app's output template.
     100 * Each job will have its own set of arguments and input files.
     101   But there is a single set of output filenames.
     102 * The input <dst filename>s must agree with the app's template.
     103 * If 'ALL' is given instead of <#output files>,
     104   then no filenames will follow.
     105 * If output filenames are provided, then they must agree with
     106   the app's output template.
    99107 * As of now, <dst filename> will always be the filename part
    100108   of <src path>
    101109 * We could add a <dir> argument to prepend to input paths.
    102110
     111Query the status of a batch's jobs:
    103112{{{
    104113BOINC_QUERY_BATCH <req id> <batch name>
     
    110119 * status is either NOT_STARTED, IN_PROGRESS, DONE, or ERROR
    111120
    112 {{{
    113 BOINC_FETCH_OUTPUT <req id> <job name> <dir>
     121Retrieve a job's output files:
     122{{{
     123BOINC_FETCH_OUTPUT <req id> <job name> <dir> <stderr name>
    114124    ALL|<#files>
    115125    <src name> <dst name>
    116126    ...
    117127Result:
    118   NULL|error_msg
    119 }}}
    120 Retrieves a job's output files.
    121 
     128  error_msg | NULL <exit status> <runtime stats and ???>
     129}}}
     130Notes:
     131 * <dir> is a directory on the local machine to be used to
     132   resolve relative pathnames.
     133 * <src name> is a filename written by the job
     134 * <dst name> is a filename on the local machine where the
     135   corresponding <src name> file's contents should be written
     136 * If 'ALL' is given instead of <#files>,
     137   then no filenames will follow.
     138 * The exact format of runtime stats and related data is yet
     139   to be determined.
     140
     141Abort the given jobs:
    122142{{{
    123143BOINC_ABORT_JOBS <req id> <job name> ...
     
    125145  NULL|<err msg>
    126146}}}
    127 Abort the given jobs.
    128 
     147
     148Retire a batch:
    129149{{{
    130150BOINC_RETIRE_BATCH <req id> <batch name>
     
    132152  NULL|<err msg>
    133153}}}
    134 Retire the given batch; its files and database records can be deleted.
    135 
     154The batch's files and database records can be deleted.
     155
     156Set the "lease time" for a batch:
    136157{{{
    137158BOINC_SET_LEASE <req id> <batch name> <new lease time>
     
    139160  NULL|<err msg>
    140161}}}
    141 Set the "lease time" for a batch.
    142162After this time its files and database records can be deleted.
    143163
     164Results command:
    144165{{{
    145166RESULTS