Changes between Version 62 and Version 63 of RemoteJobs

Timestamp:

Mar 18, 2018, 11:24:44 PM (7 years ago)

Author:

davea

Comment:

--

RemoteJobs

@@ -3 +3 @@
 = RPCs for remote job submission =
 This document describes APIs for remotely submitting, monitoring, and controlling jobs on a BOINC server.
-The APIs supports the submission of '''batches''' of jobs, which may contain a single job or many thousands of jobs.
+The APIs supports the submission of '''batches''' of jobs,
+which may contain a single job or many thousands of jobs.
 
 At the bottom level, the interface consists of Web RPCs.
@@ -49 +50 @@
  * '''input_template_filename''': an optional [wiki:JobTemplates input template file name].
  * '''output_template_filename''': an optional [wiki:JobTemplates output template file name].
+ * '''job_params''': optional job parameters (include the ones you want to specify):
+   * '''rsc_disk_bound''': limit on disk usage in bytes
+   * '''rsc_fpops_est''': estimated computing in FLOPs
+   * '''rsc_fpops_bound''': upper bound on computing (abort if exceeded)
+   * '''rsc_memory_bound''': maximum memory usage
+   * '''delay_bound''': maximum turnaround time: if exceeded, create another instance of job.
  * '''app_version_num''': if present, [JobPinning pins] the jobs to a particular app version number.
  * '''jobs''': an array of job descriptors, each of which contains
@@ -278 +285 @@
 {{{
 int submit_jobs(
-    const char* project_url,
-    const char* authenticator,
-    char app_name[256],
-    int batch_id,
-    vector<JOB> jobs,
-    string& error_msg
+        const char* project_url,
+        const char* authenticator,
+        char app_name[256],
+        int batch_id,
+        vector<JOB> jobs,
+        string& error_msg,
+        app_version_num = 0
+);
+
+int submit_jobs2(
+        const char* project_url,
+        const char* authenticator,
+        char app_name[256],
+        int batch_id,
+        vector<JOB> jobs,
+        string& error_msg,
+        app_version_num,
+        JOB_PARAMS&
 );
 
 struct JOB {
-    char job_name[256];
-    string cmdline_args;
-    vector<INFILE> infiles;
+        char job_name[256];
+        string cmdline_args;
+        vector<INFILE> infiles;
+};
+
+struct JOB_PARAMS {
+    // 0 means unspecified for all params
+    double rsc_disk_bound;
+    double rsc_fpops_est;
+    double rsc_fpops_bound;
+    double rsc_memory_bound;
+    double delay_bound;
 };
 
@@ -590 +618 @@
 This example is functional and it shows how to use the API.
 However, you will have to modify it for your particular applications and web site.
+