# This document provides a schema for representing a request
# for network measurement data. It is based on the draft
# document Requirements for a measurment request

namespace local = ""
default namespace tns = "http://www.ggf.org/namespaces/2004/10/gridNetworkMonitoring"

grammar {

   include "nm_subject.rnc"
   include "nm_params.rnc"
   include "nm_tool.rnc"
   include "nm_timeinfo.rnc"
   include "nm_statistic.rnc"
   include "nm_extend.rnc"
   
   NetworkMeasurementRequest =
      element request { Request }+,
      attribute version { token }?
   Request =
      ## The requested characteristic
      element characteristic { token },
      ## The subject of the measurement(s) to be returned
      element subject { ( element node { Node } | Name | element path { Path } ), Report},
      ## The methodology to employ
      element methodology { Methodology }?,
      ## A request for statistics to be returned
      element statistics { Statistics }?,
      ## The maximum number of measurements to be returned
      # Enumerations break wsdl2spy
      #attribute maxResults { token "unbounded" | xsd:positiveInteger }?,
      attribute maxResults { token | xsd:positiveInteger }?,
      ## If false, new measurements should not be made to satisfy this request
      attribute allowNewMeasurements { xsd:boolean }?,
      ## If true, everything that can be reported, should be, otherwise individual report attributes are used.
      attribute reportEverything { xsd:boolean }?
   Methodology =
      ## The measurement(s) should have been made using this tool, if this element is present
      element tool { Tool }?,
      ## The measurement(s) must have been made in this time period
      element when {  TimeInformation }?,
      ## Tool parameters
      element parameterSet { ParameterSet }*
   # This is a global declaration as "required" will be used all over the place
   ## If true, the appropriate parameter is required to be the given value. The default is false.
   Required = attribute required { xsd:boolean }?
   # This is a global declaration as "report" will be used all over the place
   ## If true, the appropriate parameter should be reported in the response.
   ## The default is networkMeasurementRequest/request#reportEverything)
   Report = attribute report { xsd:boolean}?
   # This is a global declaration as "range" will be used all over the place
   ## One of "min", "max" or "exact" to indicate a range of numeric values. The default is "exact".
   ## If "min", the parameter should be at least the given value; if "max", the parameter should be at most the given value; if "exact", the parameter should be exactly this value.
   ## attribute range { token "min" | token "max" | token "exact" }?
   Range = attribute range { token }?
   ## One of source or destination, or omitted to indicate neither, either or both.
   ## attribute endpoint { token "source" | token "destination" }?
   Endpoint = attribute endpoint { token }?

}