Raw HTTP/VOV Interface
/raw/label/id
Return a label for node with the given ID. This interface is used by the applets that display the grid and graph.
Examples:
/raw/label/000290903/raw/jobqueue
Returns the number of jobs in the queue.
/raw/microevents
This URL is associated with a stream of events where each event has the following format:
subject verb id auxwhere
subject- Is an integer defined by vovinternal.h. In particular, 0=node 1=place 2=transition 3=annotation 5=nodeset
verb- Is an integer with the following meaning defined by event.hh. In particular, 1=create 2=forget 6=connect 7=disconnect 8=change 14=overflow
id- Is the ID of the entity involved in the event
aux- Is either 1 or 2 integers specifying more information about the event.
- If the verb is CHANGE, then aux is an integer representing the new node status.
- If verb is MOVE, then
auxis two integer specifying the new X and Y location of the node - Otherwise,
auxis the VovId of another node involved in the event
/raw/grid
This URL accepts the following options:
- Option
- Description
- id
- ID of the set
- name
- Name of the set. If both name and id are specified, name prevails.
Examples:
/raw/grid?id=0034345The URL returns list of nodes in the specified set using the following
format:
id type x y status label
where:
- id
- Is the VovId of the node
- type
- Is an integer: 1=file, 2=job, 5=barrier file
- x
- The x coordinate of the node
- y
- The y coordinate of the node
- status
- Is an integer expressing the status of the node (0=valid, 1=invalid, 3=running, ...)
- label
- On a line by itself, is a string of characters to be associated with the node.
The list is terminated by an empty line.
/raw/graph
This URL returns a list of nodes followed by a list of arcs. The
options are the same as for /raw/grid The format of the list of nodes is also the
same as for /raw/grid. Each arc is expressed by a pair of VovId's:
fromId toIdand is terminated by an empty line.
/raw/taskers
This URL returns the encoded information about the status of the taskers.
id name status statuscolorwhere:
- id
- Is an integer which is the tasker identifier
- name
- Is a string which is the name of the tasker
- status
- Is a string that represents the status of the tasker (e.g. Idle, Working, ...)
- statuscolor
- Is a color associated with the tasker status.
The list is terminated by an empty line.
/raw/resource
Show the utilization of the specified resource over time. The following options are
accepted:
- Option
- Description
- name
- The name of the resource. This option is required.
- start
- The start of the time window (UT). The default is the time corresponding to one week ago.
- finish
- The start of the time window (UT). The default is the start time plus one week.
If the finish time is before the start time, the URL silently returns an empty file.
Examples:
/raw/resource?name=diskio
/raw/resource?name=diskio&start=950138888&finish=950200000The output consists of pairs of the form (time quantity) where time is either
absolute (if it begins with a digit) or relative to the previous one if it begins
with a + sign. Example:
949544831 1
+10 0
+5 1
+4 0
+3 1
+3 0
+3 1
+3 0
+2 1
+2 0
+2 1
+52 0
+2 1
+3 0
950146174 0 /raw/tool
Same as /raw/resource.