Changes between Version 4 and Version 5 of AppPlan

Timestamp:

Mar 20, 2008, 9:14:43 PM (17 years ago)

Author:

davea

Comment:

--

AppPlan

@@ -18 +18 @@
 The scheduler is linked with a project-supplied function
 {{{
-bool app_plan(HOST&, char* plan_class, HOST_USAGE&);
+bool app_plan(SCHEDULER_REQUEST &sreq, char* plan_class, HOST_USAGE&);
 }}}
-The HOST argument describes the host's CPU(s),
-and includes a field 'coprocs' listing its coprocessors.
+The '''sreq''' argument contains various data:
+ * in '''sreq.host''' field, a description of the host's processors and memory
+ * in '''sreq.global_prefs''' field, a parsed version of the user's global preferences
+ * in '''sreq.coprocs''', a list of its coprocessors.
 
-When called with a particular HOST and plan class,
+
+When called with a particular SCHEDULER_REQUEST and plan class,
 the function returns true if the host's resources are sufficient for apps of that class.
 If true, it populates the HOST_USAGE structure:
@@ -29 +32 @@
 struct HOST_USAGE {
    COPROCS coprocs;   // coprocessors used by the app (name and count)
-   double ncpus;      // #CPUs used by app (may be fractional)
+   double avg_ncpus;  // avg #CPUs used by app (may be fractional)
+   double max_ncpus;  // max #CPUs used (relevant if user changes prefs later)
    double flops;      // estimated FLOPS
-   char opaque[256];  // passed to the app in init_data.xml
+   char opaque[256];  // passed to the app in init_data.xml;
+                      // this can be used to control the # of threads used
 };
 }}}
@@ -38 +43 @@
 the scheduler examines all latest-version app_versions for the platform,
 calls '''app_plan()''' for each,
-and selects the one for which flops is greatest.
+and selects the one for which '''flops''' is greatest.
+The client uses '''flops''' to estimate job completion times.
 
 The scheduler reply includes, for each app version, an XML encoding of HOST_USAGE.
@@ -45 +51 @@
 It only runs an app if enough instances are available.
 
-The client uses app_version.usage.flops to estimate job completion times.
 
 == Notes ==