From 4321040d0834ce422c64c2b83bd90803057720e3 Mon Sep 17 00:00:00 2001
From: Patrick Holthaus <patrick.holthaus@uni-bielefeld.de>
Date: Tue, 5 Sep 2017 14:35:18 +0200
Subject: [PATCH] add importance field to resource allocation type

---
 .../communicationpatterns/ResourceAllocation.proto | 23 +++++++++++++++++++---
 1 file changed, 20 insertions(+), 3 deletions(-)

diff --git a/proto/sandbox/rst/communicationpatterns/ResourceAllocation.proto b/proto/sandbox/rst/communicationpatterns/ResourceAllocation.proto
index 6798f01..b483c45 100644
--- a/proto/sandbox/rst/communicationpatterns/ResourceAllocation.proto
+++ b/proto/sandbox/rst/communicationpatterns/ResourceAllocation.proto
@@ -13,9 +13,16 @@ import "rst/timing/Interval.proto";
  * The type is meant to be exchanged between a scheduling component
  * and its clients based on the current state in the allocations life
  * cycle. Target resources can be specified by one or more string
- * identifiers. In order to allow a scheduling component to arbitrate
- * between allocations, also an initiator (human or system), and a
- * conflict resolution strategy have to be specified.
+ * identifiers.
+ *
+ * In order to allow a scheduling component to arbitrate
+ * between allocations, also an initiator (human or system), a numerical
+ * importance value and a conflict resolution strategy have to be specified.
+ * Scheduling components are advised to evaluate information in the following
+ * order:
+ * i) Prefer a higher priority
+ * ii) Prefer a human initiator over a system initiator
+ * iii) Prefer a higher importance value
  *
  * @author Patrick Holthaus <patrick.holthaus@uni-bielefeld.de>
  */
@@ -189,6 +196,16 @@ message ResourceAllocation {
      */
     required Priority priority = 30;
 
+    /**
+     * Importance of resource allocation.
+     *
+     * Higher importance values indicate that an allocation attempt should be
+     * preferred over attempts with lower importance if both have the same
+     * priority and initiator. If no importance value is specified, it's value
+     * is assumed to be zero.
+     */
+    optional uint32 importance = 45;
+
     /**
      * Initiator of resource allocation.
      */
-- 
2.14.1