Network Working Group                                         C. Boulton
Internet-Draft                                           NS-Technologies
Intended status: Standards Track                              L. Miniero
Expires: March 29, 2010                             University of Napoli
                                                      September 25, 2009


                        Media Resource Brokering
                      draft-ietf-mediactrl-mrb-01

Status of this Memo

   This Internet-Draft is submitted to IETF in full conformance with the
   provisions of BCP 78 and BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF), its areas, and its working groups.  Note that
   other groups may also distribute working documents as Internet-
   Drafts.

   Internet-Drafts are draft documents valid for a maximum of six months
   and may be updated, replaced, or obsoleted by other documents at any
   time.  It is inappropriate to use Internet-Drafts as reference
   material or to cite them other than as "work in progress."

   The list of current Internet-Drafts can be accessed at
   http://www.ietf.org/ietf/1id-abstracts.txt.

   The list of Internet-Draft Shadow Directories can be accessed at
   http://www.ietf.org/shadow.html.

   This Internet-Draft will expire on March 29, 2010.

Copyright Notice

   Copyright (c) 2009 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents in effect on the date of
   publication of this document (http://trustee.ietf.org/license-info).
   Please review these documents carefully, as they describe your rights
   and restrictions with respect to this document.








Boulton & Miniero        Expires March 29, 2010                 [Page 1]


Internet-Draft          Media Resource Brokering          September 2009


Abstract

   The MediaCtrl work group in the IETF is currently proposing an
   architecture for controlling media services.  The Session Initiation
   Protocol (SIP) will be used as the signalling protocol which provides
   many inherent capabilities for message routing.  In addition to such
   signalling properties, a need exists for intelligent, application
   level media service selection based on non-static signalling
   properties.  This is especially true when considered in conjunction
   with deployment architectures that include 1:M and M:M combinations
   of Application Servers and Media Servers.


Table of Contents

   1.  Introduction . . . . . . . . . . . . . . . . . . . . . . . . .  3
   2.  Conventions and Terminology  . . . . . . . . . . . . . . . . .  6
   3.  Problem Discussion . . . . . . . . . . . . . . . . . . . . . .  7
   4.  Deployment Scenario Options  . . . . . . . . . . . . . . . . .  8
     4.1.  Query MRB  . . . . . . . . . . . . . . . . . . . . . . . .  8
       4.1.1.  Hybrid Query MRB . . . . . . . . . . . . . . . . . . .  9
     4.2.  In-Line MRB  . . . . . . . . . . . . . . . . . . . . . . . 10
   5.  MRB Interface Definitions  . . . . . . . . . . . . . . . . . . 13
     5.1.  Media Server Resource Publishing Interface . . . . . . . . 13
       5.1.1.  Control Package Definition . . . . . . . . . . . . . . 14
       5.1.2.  Element Definitions  . . . . . . . . . . . . . . . . . 16
       5.1.3.  <mrbrequest> . . . . . . . . . . . . . . . . . . . . . 16
       5.1.4.  <mrbnotification>  . . . . . . . . . . . . . . . . . . 17
       5.1.5.  <mrbresponse>  . . . . . . . . . . . . . . . . . . . . 24
     5.2.  Media Service Resource Consumer Interface  . . . . . . . . 25
       5.2.1.  Media Service Resource Request . . . . . . . . . . . . 25
       5.2.2.  Media Service Resource Response  . . . . . . . . . . . 26
     5.3.  In-Line MRB Interface  . . . . . . . . . . . . . . . . . . 27
       5.3.1.  In-line Unaware MRB Mode . . . . . . . . . . . . . . . 27
       5.3.2.  In-line Aware MRB Mode . . . . . . . . . . . . . . . . 27
   6.  Media Service Resource Publisher Interface XML Schema  . . . . 30
   7.  Media Service Resource Consumer Interface XML Schema . . . . . 47
   8.  Security Considerations  . . . . . . . . . . . . . . . . . . . 49
   9.  IANA Considerations  . . . . . . . . . . . . . . . . . . . . . 50
   10. Changes  . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
     10.1. Changes from 01 Version  . . . . . . . . . . . . . . . . . 51
   11. Acknowledgments  . . . . . . . . . . . . . . . . . . . . . . . 52
   12. References . . . . . . . . . . . . . . . . . . . . . . . . . . 53
     12.1. Normative References . . . . . . . . . . . . . . . . . . . 53
     12.2. Informative References . . . . . . . . . . . . . . . . . . 54
   Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 55





Boulton & Miniero        Expires March 29, 2010                 [Page 2]


Internet-Draft          Media Resource Brokering          September 2009


1.  Introduction

   The topic of Media Resources has been in discussion for a number of
   years with varying proprietary solutions being used today.  It is
   clear that, as we move towards a consistent architecture and protocol
   for Media Server Control, a standard mechanism is required for
   accurate media resource location.

   As IP based multimedia infrastructures mature, the complexity and
   demands from deployments increase.  Such complexity will result in a
   wide variety of capabilities from a range of vendors that should all
   be interoperable using the architecture and protocols produced by the
   MediaCtrl work group.  It should be possible for a controlling entity
   to be assisted in Media Server selection so that the most appropriate
   resource is selected for a particular operation.  The importance
   increases when you introduce a flexible level of deployment
   scenarios, as specified in the MediaCtrl Requirements
   [I-D.ietf-mediactrl-requirements] and MediaCtrl Architecture
   [I-D.ietf-mediactrl-architecture] documents.  These documents make
   statements like "it should be possible to have a many-to-many
   relationship between Application Servers and Media Servers that use
   this protocol".  This leads to the following deployment architectures
   being possible when considering media resources.

   The simplest deployment view is illustrated in Figure 1.



   +---+-----+---+                         +---+-----+---+
   | Application |                         |    Media    |
   |   Server    |<-------MS Control------>|    Server   |
   +-------------+                         +-------------+



                       Figure 1: Basic Architecture

   This simply involves a single Application Server and Media Server.
   Expanding on this view, it is also possible for an Application Server
   to control multiple (greater that 1) Media Server instances at any
   one time.  This deployment view is illustrated in Figure 2.
   Typically, such architectures are associated with application logic
   that requires high demand media services.  It is more than possible
   that each media server possesses a different media capability set.
   Media servers may offer different media services as specified in the
   Mediactrl architecture document.  A Media server may have similar
   media functionality but may have different capacity or media codec
   support.



Boulton & Miniero        Expires March 29, 2010                 [Page 3]


Internet-Draft          Media Resource Brokering          September 2009


                                           +---+-----+---+
                                           |    Media    |
                                    +----->|    Server   |
                                    |      +-------------+
                                    |
   +---+-----+---+                  |      +---+-----+---+
   | Application |                  |      |    Media    |
   |   Server    |<--MS Control-----+----->|    Server   |
   +-------------+                  |      +-------------+
                                    |
                                    |      +---+-----+---+
                                    +----->|    Media    |
                                           |    Server   |
                                           +-------------+


                     Figure 2: Multiple Media Servers

   Figure 3 conveys the opposite view to that in Figure 2.  In this
   model there are a number of (greater than 1) application servers
   controlling a single media server.  Typically, such architectures are
   associated with application logic that requires low demand media
   services.


   +---+-----+---+
   | Application |
   |   Server    |<-----+
   +-------------+      |
                        |
   +---+-----+---+      |                  +---+-----+---+
   | Application |      |                  |    Media    |
   |   Server    |<-----+-----MS Control-->|    Server   |
   +-------------+      |                  +-------------+
                        |
   +---+-----+---+      |
   | Application |      |
   |   Server    |<-----+
   +-------------+



                  Figure 3: Multiple Application Servers

   The final deployment view is the most complex.  In this model (M:M)
   there exists any number of Application Servers and any number of
   Media Servers.  It is again possible in this model that media servers
   might not be homogenous and have different capability sets and



Boulton & Miniero        Expires March 29, 2010                 [Page 4]


Internet-Draft          Media Resource Brokering          September 2009


   capacity.


   +---+-----+---+                         +---+-----+---+
   | Application |                         |    Media    |
   |   Server    |<-----+            +---->|    Server   |
   +-------------+      |            |     +-------------+
                        |            |
   +---+-----+---+      |            |     +---+-----+---+
   | Application |      |            |     |    Media    |
   |   Server    |<-----+-MS Control-+---->|    Server   |
   +-------------+      |            |     +-------------+
                        |            |
   +---+-----+---+      |            |     +---+-----+---+
   | Application |      |            +---->|    Media    |
   |   Server    |<-----+                  |    Server   |
   +-------------+                         +---+-----+---+


                       Figure 4: Basic Architecture

   This document will take a look at the specific problem areas related
   to such deployment architectures.  It is recognised that the
   solutions proposed in this document should be equally adaptable to
   all of the previously described deployment models.  It is also
   recognised that the solution is far more relevant to some of the
   previously discussed deployment models and can almost be viewed as
   redundant on others.























Boulton & Miniero        Expires March 29, 2010                 [Page 5]


Internet-Draft          Media Resource Brokering          September 2009


2.  Conventions and Terminology

   In this document, BCP 14/RFC 2119 [RFC2119] defines the key words
   "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD",
   "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
   "OPTIONAL".  In addition, BCP 15 indicates requirement levels for
   compliant implementations.

   This document inherits terminology proposed in the MediaCtrl
   Architecture [I-D.ietf-mediactrl-architecture] and Media Control
   Channel Framework [I-D.ietf-mediactrl-sip-control-framework]
   documents.  In addition, the following terms are defined for use in
   this document and for use in the context of the MediaCtrl Work group
   in the IETF:

   Media Resource Broker (MRB)  A logical entity that is responsible for
      both collection of appropriate published Media Server (MS)
      information and supplying of appropriate MS information to
      consuming entities.

   Query MRB  An instantiation of an MRB (See previous definition) that
      provides an interface for an Application Server to retrieve the
      location of an appropriate Media Server.  The result returned to
      the Application Server can be influenced by information contained
      in the query request.

   In-line MRB  An instantiation of an MRB (See definition) that
      directly receives requests on the signalling path.  The decision
      making process is totally delegated to the MRB.






















Boulton & Miniero        Expires March 29, 2010                 [Page 6]


Internet-Draft          Media Resource Brokering          September 2009


3.  Problem Discussion

   It is clear from Section 1 that the MediaCtrl group will be producing
   a solution that must service a wide variety of deployment
   architectures.  These range from the simplest 1:1 relationship
   between Media Servers and Application Servers to potentially linearly
   scaling 1:M, M:1 and M:M deployments.

   This still does not seem like a major issue for the proposed solution
   until you add a number of additional factors into the equation that
   increase complexity.  As Media Servers evolve it must be taken into
   consideration that, where many can exist in a deployment, they may
   not have been produced by the same vendor and may not have the same
   capability set.  It should be possible for an Application Server that
   exists in a deployment to select a Media Service based on a common,
   appropriate capability set.  In conjunction with capabilities, it is
   also important to take available resources into consideration.  The
   ability to select an appropriate Media Service function is an
   extremely useful feature but becomes even more powerful when
   considered with available resources for servicing a request.

   In conclusion, the intention is to create a tool set that allows
   MediaCtrl deployments to effectively utilize the available media
   resources.  It should be noted that in the simplest deployments where
   only a single media server exists, an MRB function is probably not
   required.  Only a single capability set exists and resource
   unavailability can be handled using the appropriate underlying
   signalling e.g.  SIP response.  This document does not prohibit such
   uses of an MRB, it simply provides the tools for various entities to
   interact where appropriate.  It is also worth noting that the tools
   provided in this document aim to provide a 'best effort' view of
   media resources at the time of request for initial Media Server
   routing decisions.  Any dramatic change in media capabilities after a
   request has taken place should be handled by the underlying protocol.

   Please note that, while the MRB is supposed to provided ASs with as
   much relevant information as possible, there are information pieces
   that ASs may be interested to which are out of scope in this
   document, as for instance reservation requests, MS resource
   allocation rules, planned or unplanned downtime of MS resources, the
   planned addition of future MS resources and the like.










Boulton & Miniero        Expires March 29, 2010                 [Page 7]


Internet-Draft          Media Resource Brokering          September 2009


4.  Deployment Scenario Options

   On researching Media Resource Brokering it became clear that a couple
   of high level models exist.  The general principles of "in-line" and
   "query" MRB concepts are discussed in the rest of this section.

4.1.  Query MRB

   The "Query" model for MRB interactions provides the ability for a
   client of media services (for example an Application Server) to "ask"
   an MRB for an appropriate Media Server, as illustrated in Figure 5.


                        +---+-----+---+
          +------------>|     MRB     |<----------+----<-----+---+
          |             +-------------+        (1)|          |   |
          |                                       |          |   |
          |(2)                             +---+--+--+---+   |   |
          |                                |    Media    |   |   |
          |                          +---->|    Server   |   |   |
          |                          |     +-------------+   |   |
          |                          |                    (1)|   |
   +---+--+--+---+                   |     +---+-----+---+   |   |
   | Application |                   |     |    Media    |   |   |
   |   Server    |<-----+-MS Control-+---->|    Server   |->-+   |
   +-------------+          (3)      |     +-------------+       |
                                     |                           |
                                     |     +---+-----+---+    (1)|
                                     +---->|    Media    |       |
                                           |    Server   |--->---+
                                           +---+-----+---+


                            Figure 5: Query MRB

   In this deployment, the Media Servers use the "Media Server Resource
   Publishing Interface", as discussed in Section 5.1, to convey
   capability sets as well as resource information.  This is depicted by
   (1) in Figure 5.  It is then the MRB's responsibility to accumulate
   all appropriate information relating to media services in the logical
   deployment cluster.  The Application Server (or other media services
   client) is then able to query the MRB for an appropriate resource (as
   identified by (2) in Figure 5).  Such a query would carry specific
   information related to the Media Service required and enable the MRB
   to provide an increased accuracy in its response.  This particular
   interface is discussed in "Media Resource Consumer Interface" in
   Section 5.2.  The Application Server is then able to direct control
   commands (for example create conference) and Media Dialogs to the



Boulton & Miniero        Expires March 29, 2010                 [Page 8]


Internet-Draft          Media Resource Brokering          September 2009


   appropriate Media Server, as shown by (3) in Figure 5.

4.1.1.  Hybrid Query MRB

   As mentioned previously, it is the intention that a tool kit is
   provided for MRB functionality within a MediaCtrl architecture.  It
   is expected that in specific deployment scenarios the role of the MRB
   might be co-hosted as a hybrid logical entity with an Application
   Server, as shown in Figure 6.


          +------------<----------------<---------+----<-----+---+
          |                     (1)               |          |   |
          |                                       |          |   |
          |                                +---+--+--+---+   |   |
          |                                |    Media    |   |   |
          V                          +---->|    Server   |   |   |
   +------+------+                   |     +-------------+   |   |
   |     MRB     |                   |                       |   |
   +---+--+--+---+                   |     +---+-----+---+   |   |
   | Application |                   |     |    Media    |   |   |
   |   Server    |<-----+-MS Control-+---->|    Server   |->-+   |
   +-------------+                   |     +-------------+       |
                                     |                           |
                                     |     +---+-----+---+       |
                                     +---->|    Media    |       |
                                           |    Server   |--->---+
                                           +---+-----+---+


                  Figure 6: Hybrid Query MRB - AS Hosted

   This diagram is identical to that in Figure 5 with the exception that
   the MRB is now hosted on the Application Server.  The "Media Server
   Publishing Interface" is still being used to accumulate resource
   information at the MRB but as it is co-hosted on the Application
   Server, the "Media Server Consumer Interface" has collapsed.  It
   might still exist within the Application Server/MRB interaction but
   this is an implementation issue.  This type of deployment suits a
   single Application Server environment but it should be noted that a
   "Media Server Consumer Interface" could then be offered from the
   hybrid if required.

   In a similar manner, the Media Server could also act as a hybrid for
   the deployment cluster, as illustrated in Figure 7.






Boulton & Miniero        Expires March 29, 2010                 [Page 9]


Internet-Draft          Media Resource Brokering          September 2009


                                   (1)                 +---+-----+---+
   +---+---+------------->---------------->----------->|     MRB     |
   |   |   |   +---+--+--+---+                         +---+-----+---+
   |   |   +-<-| Application |                         |    Media    |
   |   |       |   Server    |<--+-MS Control-+------->|    Server   |
   |   |       +-------------+                   |     +-------------+
   |   |                                         |
   |   |       +---+--+--+---+                   |
   |   +---<---| Application |                   |
   |           |   Server    |<--+-MS Control-+--+
   |           +-------------+                   |
   |                                             |
   |           +---+--+--+---+                   |
   +---<-------| Application |                   |
               |   Server    |<--+-MS Control-+--+
               +-------------+





                  Figure 7: Hybrid Query MRB - MS Hosted

   This time the MRB has collapsed and is co-hosted by the Media Server.
   The "Media Server Consumer Interface" is still available to the
   Application Servers (1) to query Media Server resources.  This time
   the "Media Server Publishing Interface" has collapsed onto the Media
   Server.  It might still exist within the Media Server/MRB interaction
   but this is an implementation issue.  This type of deployment suits a
   single Media Server environment but it should be noted that a "Media
   Server Publishing Interface" could then be offered from the hybrid if
   required.  A typical use case scenario for such a topology would be a
   single MS representing a pool of MSs in a cluster.  In that case, the
   MRB would actually be handling a cluster of MSs, rather than one.

4.2.  In-Line MRB

   The "In-line" MRB is architecturally different from the "Query" model
   that was discussed in the previous section.  The Concept of a "Media
   Server Consumer Interface" disappears.  The client of the MRB simply
   uses the signalling to offload the decision making process - this
   applies to both media server Control and Media dialogs.  This type of
   deployment is illustrated in Figure 8.








Boulton & Miniero        Expires March 29, 2010                [Page 10]


Internet-Draft          Media Resource Brokering          September 2009


                               +-------<----------+----<-------+---+
                               |                  | (1)        |   |
                               |                  |            |   |
                               |             +---+--+--+---+   |   |
                               |             |    Media    |   |   |
                               |     +------>|    Server   |   |   |
                               |     |(3)    +-------------+   |   |
                               |     |                      (1)|   |
   +---+--+--+---+             |     |       +---+-----+---+   |   |
   | Application |  (2) +---+--V--+---+  (3) |    Media    |   |   |
   |   Server    |----->|     MRB     |----->|    Server   |->-+   |
   +-------------+      +---+-----+---+      +-------------+       |
                                     |                             |
                                     |   (3) +---+-----+---+    (1)|
                                     +------>|    Media    |       |
                                             |    Server   |--->---+
                                             +---+-----+---+


                           Figure 8: In-line MRB

   The Media Servers still use the 'Media Server Publishing Interface'
   to convey capabilities and resources to the MRB - as illustrated by
   (1).  The media server Control and Media dialogs are sent to the MRB
   (2) which then selects an appropriate Media Server (3).  The result
   of such an architecture is that the signalling decision is left
   entirely to the MRB and the Application Server has no choice in the
   final selection process.  This is the opposite to the "Query" model
   which provided information that would help influence the Media Server
   decision making process on the application server and resulted in it
   directly contacting an appropriate Media Server instance.  As a by-
   product of this decision shift, a lot more emphasis is placed on the
   intelligence of the MRB to interpret the required capabilities of the
   request.  The MRB will actually have to inspect both the SIP
   signalling and the media server control protocol PDUs for the purpose
   of Media Server selection.  This includes, for example, looking for
   explicit capabilities in the signalling and session details such as
   media types, codecs and bandwidth requirements.  Ultimately the
   decision making and policy enforcement is removed from the
   Application Server and shifted to the MRB logical entity.

   In-line MRB can be split into two distinct logical roles which can be
   applied on a per request basis.  They are:

   In-line Unaware MRB Mode (IUMM))  Allows an MRB to act on behalf of
      clients requiring media services who are not aware of an MRB or
      its operation.




Boulton & Miniero        Expires March 29, 2010                [Page 11]


Internet-Draft          Media Resource Brokering          September 2009


   In-line Aware MRB Mode (IAMM)  Allows an MRB to act on behalf of
      clients requiring media services who are aware of an MRB and its
      operation.

   The two modes are discussed in more detail in Section 5.3.














































Boulton & Miniero        Expires March 29, 2010                [Page 12]


Internet-Draft          Media Resource Brokering          September 2009


5.  MRB Interface Definitions

   As discussed in previous sections in this document, the intention is
   to provide a toolkit for a variety of deployment architectures where
   media resource brokering can take place.  As a result, two main
   interfaces are required to support the differing requirements.  The
   two interfaces are described in the remainder of this section and
   have been named the 'Media Server Resource Publishing' and 'Media
   Server Resource Consumer' interfaces.  These two interfaces have
   extremely differing responsibilities and usages which is reflected in
   the choice of solutions.

   It is beyond the scope of this document to define exactly how to
   construct an MRB.  This includes interpreting the data for the Media
   Service Consumer interface supplied by the Media Server Publishing
   interface.  It is, however, important that the two interfaces are
   complimentary so that development of appropriate MRB functionality is
   supported.

5.1.  Media Server Resource Publishing Interface

   The Media Server Resource Publishing interface is responsible for
   providing an MRB with appropriate Media Server resource information.
   It is generally accepted that this interface provides both general
   and specific details related to Media Server resources.  This
   information needs to be conveyed using an industry standard mechanism
   to provide increased levels of adoption and interoperability.  A
   Control Package for the Media Control Channel Framework will be
   specified to fulfil this interface requirement.  It provides the
   perfect establishment and monitoring mechanism to enable a Media
   Server to report appropriate statistics to an MRB.  The Publish
   interface is used with both Query and In-line modes of MRB operation.

   As already anticipated in the introduction, the information provided
   by the Media Server is to be considered a best effort.  This means
   that while the information is assumed to be as exact as possible, it
   can only be considered a good approximation rather than the exact
   information.  It is clear, in fact, that the accuracy of MRB resource
   availability will never be exact due to several reasons which include
   timing issues, computed as opposed to reserved resource consumption
   (e.g., DSP's with a fixed number of streams versus GPU's with CPU
   availability), and licensing (e.g., even if lots of CPU and memory
   are available, licensing or other configuration elements may restrict
   the number of stream types).  This implies that the only way an
   Application Server can be sure a specific resource is available is to
   reserve it by establishing a session.  For the same reason, the
   reporting of resources availability has no relation to predictive
   resource allocation.  A typical example of that is a conference



Boulton & Miniero        Expires March 29, 2010                [Page 13]


Internet-Draft          Media Resource Brokering          September 2009


   bridge that allows for oversubscription.  The oversubscription must
   be taken care of at the application layer in the Application Server,
   since requests to the Media Server must be for the actual number of
   streams requested.

   It is also worth noting that, while the scope of the MRB is
   definitely on providing interested Application Servers with the
   available resources, the MRB also allows for the retrieval of
   information about the currently occupied resources.  While this is of
   course a relevant piece of information (e.g. for monitoring
   purposes), such a functionality inevitably raises security
   considerations, and implementations should take this into account.
   See Section 8 for more details.

   The MRB Publish interface uses the Media Control Channel Framework
   ([I-D.ietf-mediactrl-sip-control-framework]) as the basis for
   interaction between a Media Server and an MRB.  The Media Control
   Channel Framework uses an extension mechanism to allow specific
   usages which are known as control packages.  Section 5.1.1 defines
   the control package that MUST be implemented by any Media Server
   wanting to interact with an MRB entity.

5.1.1.  Control Package Definition

   This section fulfils the mandatory requirement for information that
   MUST be specified during the definition of a Control Framework
   Package, as detailed in Section 8 of
   [I-D.ietf-mediactrl-sip-control-framework].

5.1.1.1.  Control Package Name

   The Media Channel Control Framework requires a Control Package
   definition to specify and register a unique name and version.

   The name and version of this Control Package is "mrb-publish/1.0".

5.1.1.2.  Framework Message Usage

   The MRB publishing interface allows a media server to convey
   available capabilities and resources to an MRB entity.

   This package defines XML elements in Section 5.1.2 and provides an
   XML Schema in Section 6.

   The XML elements in this package are split into requests, responses
   and event notifications.  Requests are carried in CONTROL message
   bodies; <mrbrequest> element is defined as a package request.  Event
   notifications are also carried in CONTROL message bodies; the



Boulton & Miniero        Expires March 29, 2010                [Page 14]


Internet-Draft          Media Resource Brokering          September 2009


   <mrbnotification> element is defined for package event notifications.
   Responses are carried either in REPORT message or Control Framework
   200 response bodies; the <mrbresponse> element is defined as a
   package level response.

   Note that package responses are different from framework response
   codes.  Framework error response codes (see Section 7 of
   [I-D.ietf-mediactrl-sip-control-framework]) are used when the request
   or event notification is invalid; for example, a request has invalid
   XML (400), or is not understood (500).  Package level responses are
   carried in framework 200 response or REPORT message bodies.  This
   package's response codes are defined in Section 5.1.5.

5.1.1.3.  Common XML Support

   The Control Framework requires a Control Package definition to
   specify if the attributes for media dialog or conference references
   are required.

   [Editors Note: *TODO*.]

5.1.1.4.  CONTROL Message Body

   A valid CONTROL body message MUST conform to the schema defined in
   Section 6 and described in Section 5.1.2.  XML messages appearing in
   CONTROL messages MUST contain either a <mrbrequest> or
   <mrbnotification> element.

5.1.1.5.  REPORT Message Body

   A valid REPORT body MUST conform to the schema defined in Section 6
   and described in Section 5.1.2.  XML messages appearing in REPORT
   messages MUST contain a <mrbresponse> element.

5.1.1.6.  Audit

   *TODO*.

   [Editors Note: do we really need an Audit section for this package?
   Auditing is not a mandatory operation in a package, but the framework
   encourages its use.  If we add this here, are we saying that there
   are things a MRB may or may not do, and auditing tells you about it?
   Or could it be used as a monitoring entity?]

5.1.1.7.  Examples

   [Editors Note: TODO].




Boulton & Miniero        Expires March 29, 2010                [Page 15]


Internet-Draft          Media Resource Brokering          September 2009


5.1.2.  Element Definitions

   This section defines the XML elements for the Publish interface Media
   Control Channel package defined in Section 5.1.  The formal XML
   schema definition for the Publish interface can be found in
   Section 6.

   The root element is <mrbpublish>.  All other XML elements (requests,
   responses, notifications) are contained within it.  The MRB Publish
   interface request element is detailed in Section 5.1.3.  The MRB
   Publish interface notification element is detailed in Section 5.1.4.
   MRB Publish interface response element is contained in Section 5.1.5.

   The <mrbpublish> element has the following attributes:

   Version)  a token specifying the mrb-publish package version.  The
      value is fixed as '1.0' for this version of the package.  The
      attribute is mandatory.

   The <mrbpublish> elements has the following child elements, only one
   of which is allowed to occur.

      <mrbrequest> for sending an MRB request.  See Section 5.1.3.

      <mrbresponse> for sending an MRB response.  See Section 5.1.5.

      <mrbnotification> for sending an MRB notification.  See
      Section 5.1.4.

5.1.3.  <mrbrequest>

   This section defines the <mrbrequest> element used to initiate
   requests from an MRB to a Media Server.  The element is a container
   for information relevant for the interrogation of a media server.

   The <mrbrequest> element has no defined attributes.

   The <mrbrequest> element has the following sub-elements which are
   defined in the remainder of this section:

      <subscription> for initiating a subscription to a Media Server
      from an MRB.  See Section 5.1.3.1.

5.1.3.1.  <subscription>

   The <subscription> element is included in a request from an MRB to a
   Media Server to provide the details relating to the configuration of
   updates.  The MRB will inform the Media Server how long it wishes to



Boulton & Miniero        Expires March 29, 2010                [Page 16]


Internet-Draft          Media Resource Brokering          September 2009


   receive updates for and the frequency that updates should be sent.
   Updates are sent using the <mrbnotification> element.

   [Editors Note: Include more detail on subscription mechanism
   including responses/reject from MS + polling (not including expires
   and frequency elements constitutes a poll of the Media Server using a
   different 'id')].

   The <subscription> element has the following attributes:

   id:  indicates a unique token representing the session between the
      MRB and the Media Server.  The attribute is mandatory.

   seqnumber:  indicates a sequence number to be used in conjunction
      with the session id to identify a specific subscription command.
      The attribute is mandatory

   The <subscription> element has the following child elements:

   expires:   Provides the amount of time in seconds that a subscription
      should be installed for notifications at the Media Server.  The
      element is optional.

   frequency:   Provides the frequency in seconds that the MRB wishes to
      receive notifications from the MRB.  The element is optional.

   [Editors Note: Next version of the document will have exclude/include
   lists in MRB requests; the default behaviour is "subscribe me to
   everything you have", and the MRB package will trigger events saying
   everything it knows; we could envisage more drill-down requests like:
   1) tell me everything (default) 2) tell me everything except...
   (exclude list) 3) tell me only... (include list) this would only
   require a change in 'subscriptionType' and optional occurrences in
   'mrbnotificationType' for the reported elements; this could allow for
   more lightweight notifications for entities only interested in a
   subset of info, or for entities which want different transactions for
   different info (e.g.  "I only need to know about RTP stuff, I don't
   care about the rest");].

5.1.4.  <mrbnotification>

   The <mrbnotification> element is included in a request from a Media
   Server to an MRB to provide the details relating current status.  The
   Media Server will inform the MRB of its current status as defined by
   the information in the <subscription> element.  Updates are sent
   using the <mrbnotification> element contained in an <mrbrequest>
   element.




Boulton & Miniero        Expires March 29, 2010                [Page 17]


Internet-Draft          Media Resource Brokering          September 2009


   The <mrbnotification> element has the following attributes:

   id:  indicates a unique token representing the session between the
      MRB and the Media Server and is the same as the one appearing in
      the <subscription> element.  The attribute is mandatory.

   seqnumber:  indicates a sequence number to be used in conjunction
      with the session id to identify a specific notification update.
      The attribute is mandatory

   The following subsections provide details on the child elements that
   are contained within an <mrbnotification> element.

   [Editors Note: What is mandatory to support by Media Servers?  Do we
   want to specify that MS MUST support all elements in the mrbrequest
   OR should we specify a minumum number of elements].

5.1.4.1.  <media-server-id>

   The <media-server-id> element provides a unique system wide
   identifier for a Media Server instance.  The element is mandatory.

   [Editors Note: Need to talk more about unique property.]

5.1.4.2.  <active-rtp-sessions>

   The <active-rtp-sessions> element provides information detailing the
   current active Real-time Transport Protocol(RTP) sessions.  The
   element is optional.

   The <active-rtp-sessions> element has no attributes.

   The <active-rtp-sessions> element has the following child elements:

   rtp-codec:   Is a container which representing a supported codec and
      the active sessions.  The <rtp-codec> element has one attribute.
      The attribute 'name' represents the name of the codec being
      represented.  The <rtp-codec> element has two child elements.  The
      child element, <decoding>, represents the number of RTP sessions
      for the specified codec being decoded.  The child element,
      <encoding>, represents the number of RTP sessions for the
      specified codec being encoded.

5.1.4.3.  <active-mixer-sessions>

   The <active-mixer-sessions> element provides information detailing
   the current active mixed RTP sessions.  The element is optional.




Boulton & Miniero        Expires March 29, 2010                [Page 18]


Internet-Draft          Media Resource Brokering          September 2009


   The <active-rtp-sessions> element has no attributes.

   The <active-mixer-sessions> element has the following child elements:

   active-mix:   Is a container which representing a mixed active RTP
      session.  The <active-mix> element has one attribute.  The
      attribute 'conferenceid' represents the name of the mix being
      represented.  The <active-mix> element has one child elements.
      The child element, <rtp-codec>, contains the same information
      relating to RTP sessions as defined in Section 5.1.4.2.  The
      element is optional.

5.1.4.4.  <non-active-rtp-sessions>

   The <non-active-rtp-sessions> element provides information detailing
   the currently available inactive RTP sessions.  The element is
   optional.

   The <non-active-rtp-sessions> element has no attributes.

   The <non-active-rtp-sessions> element has the following child
   elements:

   rtp-codec:   Is a container which representing a supported codec and
      the inactive sessions.  The <rtp-codec> element has one attribute.
      The attribute 'name' represents the name of the codec being
      represented.  The <rtp-codec> element has two child elements.  The
      first child element, <decoding>, represents the number of
      available RTP session for the specified codec being decoded.  The
      second child element, <encoding>, represents the number of
      available RTP sessions for the specified codec being encoded.  The
      element is optional.

5.1.4.5.  <non-active-mixer-sessions>

   The <non-active-mixer-sessions> element provides information
   detailing the current inactive mixed RTP sessions.  The element is
   optional.

   The <non-active-rtp-sessions> element has no attributes.

   The <non-active-mixer-sessions> element has the following child
   elements:

   non-active-mix:   Is a container which representing an available
      mixed RTP session.  The <non-active-mix> element has one
      attribute.  The attribute 'available' represents the number of
      mixes that could be used using that profile.  The <non-active-mix>



Boulton & Miniero        Expires March 29, 2010                [Page 19]


Internet-Draft          Media Resource Brokering          September 2009


      element has one child elements.  The child element, <rtp-codec>,
      contains the same information relating to RTP sessions as defined
      in Section 5.1.4.4.  The element is optional.

5.1.4.6.  <media-server-status>

   The <media-server-status> element provides information detailing the
   current status of the media server.  The element is mandatory.  It
   can return one of the following values:

   active:   Indicating that the Media Server is available for service.

   deactivated:   Indicating that the Media Server has been withdrawn
      from service.

   unavailable:   Indicating that the Media Server can not process new
      requests.

   The <media-server-status> element has no attributes.

   The <media-server-status> element has no child elements.

   [Editors Note: Need to think about status messages and meanings.]

   The <media-server-status> element has no attributes.

   The <media-server-status> element has no child elements.

5.1.4.7.  <supported-codecs>

   The <supported-codecs> element provides information detailing the
   current codecs supported by a media server and associated actions.
   The element is optional.

   The <supported-codecs> element has no attributes.

   The <supported-codecs> element has the following child elements:

   supported-codec:   has a single attribute, 'name', which provides the
      name of the codec providing information.  The <supported-codec>
      element then has a further child element, <supported-codec-
      package>.  The <supported-codec-package> element has a single
      attribute, 'name', which provides the name of the Media Control
      Channel Framework package for which the codec support applies.
      The <supported-codec-package> element has one further child
      element, <supported-actions>, which provide the actions that an
      Media Server can apply to this codec (decode, encode,
      passthrough).



Boulton & Miniero        Expires March 29, 2010                [Page 20]


Internet-Draft          Media Resource Brokering          September 2009


5.1.4.8.  <application-data>

   The <application-data> element provides application level data.  The
   element is optional.

   The <application-data> element has no attributes.

   The <application-data> element has no child elements.

5.1.4.9.  <file-formats>

   The <file-formats> element provides a list of file formats supported
   for the purpose of making announcements.  The element is optional.

   The <file-formats> element has no attributes.

   The <file-formats> element has the following child elements:

   supported-format:   has a single attribute, 'name', which provides
      the type of file format that is supported.  The <supported-format>
      element then has a further child element, <supported-file-
      package>.  The <supported-file-package> element provides the name
      of the Media Control Channel Framework package for which the codec
      support applies.

5.1.4.10.  <max-prepared-duration>

   The <max-prepared-duration> element provides the amount of time a
   media dialog cane be prepared in the system before it is executed.
   The element is optional.

   The <max-prepared-duration> element has no attributes.

   The <max-prepared-duration> element has the following child elements:

   max-time:   has a single attribute, 'max-time-seconds', which
      provides the amount of time in seconds that a media dialog can be
      in the prepared state.  The <max-time> element then has a further
      child element, <max-time-package>.  The <max-time-package> element
      provides the name of the Media Control Channel Framework package
      for which the time period applies.

5.1.4.11.  <announce-var>

   The <announce-var> element supplies the supported substitution
   variables for variable announcements, including digits, dates, costs,
   etc.  The element is optional.




Boulton & Miniero        Expires March 29, 2010                [Page 21]


Internet-Draft          Media Resource Brokering          September 2009


   The <announce-var> element has no attributes.

   The <announce-var> element has the following child elements:

   param:   has a two attributes, 'name' and 'package'.  The 'name'
      attribute provides the name of the parameter.  The 'package'
      attribute provides the name of the Media Control Channel Framework
      package for which the parameter applies.  The <param> element then
      has a further child element, <param-value>.  The <param-value>
      element provides the value associated with the parameter.

   [Editors Note: TODO - the structure of this needs to change to
   reflect top level of package and the params underneath as a child].

5.1.4.12.  <dtmf-support>

   The <dtmf-support> element supplies the supported methods to detect
   DTMF tones and to generate them.  The element is optional.

   The <dtmf-support> element has no attributes.

   The <dtmf-support> element has the following child elements:

   detect:   has no attributes.  The <detect> element then has a further
      child element, <dtmf-type>.  The <dtmf-type> element has two
      attributes, 'name' and 'package.  The 'name' attribute provides
      the type of DTMF being used.  The 'package' attribute provides the
      name of the Media Control Channel Framework package for which the
      DTMF type applies.

   generate:   has no attributes.  The <generate> element then has a
      further child element, <dtmf-type>.  The <dtmf-type> element has
      two attributes, 'name' and 'package.  The 'name' attribute
      provides the type of DTMF being used.  The 'package' attribute
      provides the name of the Media Control Channel Framework package
      for which the DTMF type applies.

   passthrough:   has no attributes.  The <passthrough> element then has
      a further child element, <dtmf-type>.  The <dtmf-type> element has
      two attributes, 'name' and 'package.  The 'name' attribute
      provides the type of DTMF being used.  The 'package' attribute
      provides the name of the Media Control Channel Framework package
      for which the DTMF type applies.








Boulton & Miniero        Expires March 29, 2010                [Page 22]


Internet-Draft          Media Resource Brokering          September 2009


5.1.4.13.  <mixing-modes>

   [Editors Note: TODO after further group discussion].

5.1.4.14.  <supported-tones>

   [Editors Note: TODO after further group discussion].

5.1.4.15.  <streaming-modes>

   The <streaming-modes> element allows the Media Server to specify
   which protocols are supported for streaming to a Media Server for
   each Media Control Channel Framework package type.  For example does
   the Media Server supports audio streaming via RTSP, HTTP, NFS, etc
   protocols.  The element is optional.

   The <streaming-modes> element has no attributes.

   The <streaming-modes> element has the following child elements:

   stream-mode:   has a two attributes, 'name' and 'package'.  The
      'name' attribute provides the type of protocol that can be used
      for streaming.  The 'package' attribute provides the name of the
      Media Control Channel Framework package for which the streaming
      protocol applies.

5.1.4.16.  <asr-tts-support>

   [Editors Note: TODO after further group discussion].

5.1.4.17.  <vxml-support>

   The <vxml-support> element specifies if the Media Server supports
   VoiceXML and if it does which protocols the support is exposed
   through (eg via the control framework, or RFC5552).  The element is
   optional.

   The <vxml-support> element has a single attribute 'support'.  The
   'support' attribute is of type boolean with a value of 'true'
   indicating that the media server does support VXML, and a value of
   'false' indicating it does not support VXML.  The default value is
   'false'.

   The <vxml-support> element has the following child elements:







Boulton & Miniero        Expires March 29, 2010                [Page 23]


Internet-Draft          Media Resource Brokering          September 2009


   vxml-mode:   has a two attributes, 'package' and 'support'.  The
      'package' attribute provides the name of the Media Control Channel
      Framework package for which the streaming protocol applies.  The
      'support' attribute provides the type of VXML support provided by
      the Media Server (RFC5552 or msc-ivr/1.0).

5.1.4.18.  <media-server-location>

   [Editors Note: TODO after further group discussion].

5.1.4.19.  <label>

   The <label> element allows a Media Server to declare a piece of
   information that will be understood by the MRB.  For example, the
   Media Server can declare if its a blue or green.  Its a string to
   allow arbitrary values to be returned to allow arbitrary
   classification.  Its arbitrary as opposed to doing it purely on
   features.  The element is optional.

   The <application-data> element has no attributes.

   The <application-data> element has no child elements.

5.1.4.20.  <media-server-address>

   The <media-server-address> element allows a Media Server to provide a
   direct URI address.

   The <application-data> element has no attributes.

   The <application-data> element has no child elements.

5.1.4.21.  <encryption>

   [Editors Note: TODO after further group discussion].

5.1.5.  <mrbresponse>

   Responses to requests are indicated by a <response> element from
   Section 6.

   The <response> element has following attributes:

   status:  numeric code indicating the response status.  The attribute
      is mandatory.

   The following status codes are defined:




Boulton & Miniero        Expires March 29, 2010                [Page 24]


Internet-Draft          Media Resource Brokering          September 2009


   +-----------+-------------------------------------------------------+
   | code      | description                                           |
   +-----------+-------------------------------------------------------+
   | 200       | OK                                                    |
   +-----------+-------------------------------------------------------+

                     Table 1: <response> status codes

   [Editors Note: more status codes to be added + an example.]

5.2.  Media Service Resource Consumer Interface

   The Media Server Consumer interface provides the ability for clients
   of an MRB, such as Application Servers, to request an appropriate
   Media Server to satisfy specific criteria.  The interface allows a
   client to pass detailed meta-information to the MRB to help select an
   appropriate Media Server.  The MRB is then able to make and informed
   decision and provide the client with an appropriate media server
   resource.

   It appears the most appropriate interface for such a 'query' style
   interface is in fact a HTTP usage.  Using HTTP and XML combined
   reduces complexity and encourages use of common tools that are widely
   available in the industry today.  The following subsections explain
   the main operations required to request and then receive information
   from an MRB.  The following description will describe the use of HTTP
   RFC 2616 [RFC2616] and HTTPS RFC 2818 [RFC2818] as transport for a
   query for media resource and the appropriate response.  Examples of
   the interface can be seen in section [ref examples section].

   [Editors Note: Need to discuss the updating of a request and proposal
   of having the client supply updates on resources.  For example,
   releasing resources.]

5.2.1.  Media Service Resource Request

   The media resource query is carried in the body of an HTTP/HTTPS POST
   request.  The MIME type contained in the HTTP/HTTPS request/response
   should be 'application/mrb-consumer+xml'.  This value MUST be
   reflected in the appropriate HTTP headers like 'Content-Type' and
   'Accept'.  The body of the POST request MUST only contain the
   'mediaResourceRequest' element as defined in Section 7.  The
   'mediaResourceRequest' element is the primary container of
   information related to a media resource request and has the following
   child elements which specify the request parameters:






Boulton & Miniero        Expires March 29, 2010                [Page 25]


Internet-Draft          Media Resource Brokering          September 2009


5.2.1.1.  <mediaResourceRequest> element

   The <mediaResourceRequest> element provides a container for clients
   wishing to query an external MRB entity.  The <mediaResourceRequest>
   element has the following child elements that are used to provide
   appropriate contextual information relating to the request: [Editors
   Note: Convert groups input into appropriate XML schema.]

   o  RTP requirements - including media/codec type, codec priority.

   o  Conference requirements - number of users.

5.2.2.  Media Service Resource Response

   The use of HTTP/HTTPS for carrying the media service resource
   information has no impact on the protocol.  If protocol level
   operations and errors occur then they should be signalled as
   specified in HTTP RFC 2616 [RFC2616] and HTTPS RFC 2818 [RFC2119].  A
   successful response to a HTTP POST request containing the
   'mediaResourceRequest' MUST be responded to with a 200 OK HTTP/HTTPS
   response message.  This signifies that the request was received, was
   valid and could be responded to appropriately.  If the receiving MRB
   wishes to generate information for the requesting entity it MUST
   include a 'mediaResourceResponse' element in the 200 OK HTTP/HTTPS
   response (as discussed later in this section).  An MRB can
   alternatively return an application level error by including a
   'mediaResourceError' element in the 200 OK HTTP/HTTPS response (as
   discussed later in this section).

5.2.2.1.  <mediaResourceResponse> element

   The <mediaResourceResponse> element provides a container for the MRB
   to generate a response to a previous query.  The
   <mediaResourceResponse> element has the following child elements that
   are used to provide appropriate contextual information relating to
   the request: [Editors Note: Convert groups input into appropriate XML
   schema.]

   o  list of appropriate media server resources (include individual
      capabilities).

5.2.2.2.  <mediaResourceError> element

   The <mediaResourceError> element provides a container for the MRB to
   generate an error response to a previous query.  The
   <mediaResourceError> has element the following child elements that
   are used to provide appropriate contextual information relating to
   the request: [Editors Note: Convert groups input into appropriate XML



Boulton & Miniero        Expires March 29, 2010                [Page 26]


Internet-Draft          Media Resource Brokering          September 2009


   schema.]

   o  list of appropriate error response codes.

5.3.  In-Line MRB Interface

   An entity acting as an In-Line MRB can act in one of two roles for a
   request, as introduced in Section 4.2.  The following sub sections
   provide details for using In-Line Unaware MRB Mode (IUAMM) of
   operation and In-Line Aware MRB Mode (IAMM) of operation.

5.3.1.  In-line Unaware MRB Mode

   It should be noted that the introduction of an MRB entity into the
   network, as specified in this document, requires interfaces to be
   implemented by those requesting media server resources (for example
   an application server).  This applies when using both the Consumer
   interface as discussed in Section 5.2 and IAMM.  It is for this
   reason that an MRB is able to act in a client unaware mode when it is
   deployed into the network.  This allows any SIP compliant client
   entity, as defined by RFC 3261 [RFC3261] and its extensions, to send
   requests to an MRB and it will select an appropriate media server
   based on knowledge of media server resources it currently has
   available.  Mechanisms used to connect to media servers are detailed
   in the Media Channel Control
   Framework[I-D.ietf-mediactrl-sip-control-framework].  Using an MRB in
   this mode allows for easy migration of current applications and
   services that are unaware of the MRB concept and would simply require
   a configuration change resulting in the MRB being set as a SIP
   outbound proxy for clients requiring media services.  Any client of
   media services wishing to take advantage of the advanced techniques
   detailed in this document when using In-line mode would implement
   IAMM which is covered in Section 5.3.2.  The techniques used for
   selecting an appropriate Media Server by an MRB acting in IUMM is
   outside the scope of this document.

5.3.2.  In-line Aware MRB Mode

   An In-Line Aware Mode MRB (IAMM) is one that complies to the extended
   functionality provided in this section.  A client entity, such as an
   application server, wishing to use advanced MRB functionality can
   provide additional contextual information to an MRB.  This
   information is identical to that used in the Consumer interface in
   Section 5.2 with the only difference being the underlying transport
   mechanism of the contextual information, as specified by the
   'application/mrb-consumer+xml' payload in Section 7.  A client of an
   IAMM uses SIP signalling to convey the 'application/mrb-consumer+xml'
   payload to the IAMM.  The Consumer interface, as specified in



Boulton & Miniero        Expires March 29, 2010                [Page 27]


Internet-Draft          Media Resource Brokering          September 2009


   Section 5.2 , uses HTTP.  A client of an IAMM requiring media
   services, as well as creating a standard SIP complaint request, MUST
   use the following steps to ensure that the request is dealt with
   appropriately:

   o  The client of the IAMM constructs a SIP INVITE request to connect
      to a Media Server as detailed in the Media Channel Control
      Framework[I-D.ietf-mediactrl-sip-control-framework] with one
      exception.

   o  The client of the IAMM includes a MIME content type of multipart/
      mixed as defined in RFC 2046 [RFC2046].  As part of this mixed
      payload, the client MUST at least include a content-type of type
      'application/sdp' and a content type of type 'application/
      mrb-consumer+xml'.  The part of type application/sdp represents
      the media server connection details and MUST adhere to the Media
      Channel Control
      Framework[I-D.ietf-mediactrl-sip-control-framework].  The part of
      type 'application/mrb-consumer+xml' represents the IAMM contextual
      information and MUST adhere to the schema defined in Section 7.

   o  Once the SIP INVITE request is constructed, it is sent to the
      recipient as per RFC 3261 [RFC3261].

   [EDITORS NOTE: Include example of valid IAMM payload.]

   On receiving a SIP INVITE request containing the multipart mixed
   payload as specified previously, the IAMM will complete a number of
   steps to fulfil the request.  It will:

   o  Extract the multipart MIME payload from the SIP INVITE request.
      It will then use the contextual information provided by the client
      in the 'application/mrb-consumer+xml' part to determine which
      media server should be selected to service the request.

   o  Extract the 'application/sdp' part from the payload and use it to
      populate a new SIP INVITE request for connecting the client to the
      selected media server, as defined in the Media Channel Control
      Framework[I-D.ietf-mediactrl-sip-control-framework].  The IAMM
      acts as a Back-to-Back-UA (B2BUA) that extracts the 'application/
      mrb-consumer+xml' information from the SIP INVITE request and then
      forwards to the selected Media Server.

   [Editors Note: Consumer interface has a proposal to update a request
   for media services based on HTTP.  There are times when an
   application server might want to override the MS view of resources.
   For example, a conference where participants leave and can rejoin.
   Need to decide if this use of consumer XML should also allow for



Boulton & Miniero        Expires March 29, 2010                [Page 28]


Internet-Draft          Media Resource Brokering          September 2009


   updates using SIP reINVITE and UPDATE.]


















































Boulton & Miniero        Expires March 29, 2010                [Page 29]


Internet-Draft          Media Resource Brokering          September 2009


6.  Media Service Resource Publisher Interface XML Schema

   This section gives the XML Schema Definition [W3C.REC-xmlschema-1-
   20041028], [W3C.REC-xmlschema-2-20041028] of the "application/
   mrb-publish+xml" format.


<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema targetNamespace="urn:ietf:params:xml:ns:mrb-publish"
 elementFormDefault="qualified" blockDefault="#all"
 xmlns="urn:ietf:params:xml:ns:mrb-publish"
 xmlns:fw="urn:ietf:params:xml:ns:control:framework-attributes"
 xmlns:xsd="http://www.w3.org/2001/XMLSchema">

 <xsd:annotation>
  <xsd:documentation>
   IETF MediaCtrl MRB 1.0

   This is the schema of the IETF MediaCtrl MRB package.

   The schema namespace is urn:ietf:params:xml:ns:mrb-publish

  </xsd:documentation>
 </xsd:annotation>


 <!--
  #############################################################

  SCHEMA IMPORTS

  #############################################################
 -->

 <xsd:import namespace="http://www.w3.org/XML/1998/namespace"
  schemaLocation="http://www.w3.org/2001/xml.xsd">
  <xsd:annotation>
   <xsd:documentation>
    This import brings in the XML attributes for
    xml:base, xml:lang, etc
   </xsd:documentation>
  </xsd:annotation>
 </xsd:import>

 <xsd:import
  namespace="urn:ietf:params:xml:ns:control:framework-attributes"
  schemaLocation="framework.xsd">
  <xsd:annotation>



Boulton & Miniero        Expires March 29, 2010                [Page 30]


Internet-Draft          Media Resource Brokering          September 2009


   <xsd:documentation>
    This import brings in the framework attributes for
    conferenceid and connectionid.
   </xsd:documentation>
  </xsd:annotation>
 </xsd:import>

<!--
  #####################################################

  Extensible core type

  #####################################################
 -->


 <xsd:complexType name="Tcore">
  <xsd:annotation>
   <xsd:documentation>
    This type is extended by other (non-mixed) component types to
    allow attributes from other namespaces.
   </xsd:documentation>
  </xsd:annotation>
  <xsd:sequence/>
  <xsd:anyAttribute namespace="##other" processContents="lax" />
 </xsd:complexType>


<!--
  #####################################################

  TOP LEVEL ELEMENT: mrbpublish

  #####################################################
 -->

<xsd:complexType name="mrbpublishType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
     <xsd:choice>
      <xsd:element ref="mrbrequest" />
      <xsd:element ref="mrbresponse" />
      <xsd:element ref="mrbnotification" />
      <xsd:any namespace="##other" minOccurs="0"
       maxOccurs="unbounded" processContents="lax" />
     </xsd:choice>
    </xsd:sequence>



Boulton & Miniero        Expires March 29, 2010                [Page 31]


Internet-Draft          Media Resource Brokering          September 2009


    <xsd:attribute name="version" type="version.datatype"
      use="required" />
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="mrbpublish" type="mrbpublishType" />

<!--
  #####################################################

  mrbrequest TYPE

  #####################################################
 -->

<!--  mrbrequest -->

 <xsd:complexType name="mrbrequestType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
     <xsd:element ref="subscription" />
     <xsd:any namespace="##other" minOccurs="0"
      maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="mrbrequest" type="mrbrequestType" />

<!--  subscription -->

<xsd:complexType name="subscriptionType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
     <xsd:element name="expires" type="xsd:nonNegativeInteger"
      minOccurs="0" maxOccurs="1" />
     <xsd:element name="frequency" type="xsd:nonNegativeInteger"
      minOccurs="0" maxOccurs="1" />
     <xsd:any namespace="##other" minOccurs="0"
      maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:attribute name="id" type="id.datatype" use="required" />



Boulton & Miniero        Expires March 29, 2010                [Page 32]


Internet-Draft          Media Resource Brokering          September 2009


    <xsd:attribute name="seqnumber" type="xsd:nonNegativeInteger"
      use="required" />
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="subscription" type="subscriptionType" />


<!--
  #####################################################

  mrbresponse TYPE

  #####################################################
 -->

<!--  mrbresponse -->

 <xsd:complexType name="mrbresponseType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
    <xsd:any namespace="##other" minOccurs="0"
      maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:attribute name="status" type="status.datatype"
     use="required" />
    <xsd:attribute name="reason" type="xsd:string" />
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>


 <xsd:element name="mrbresponse" type="mrbresponseType" />

<!--
  #####################################################

  mrbnotification TYPE

  #####################################################
 -->

<!--  mrbnotification -->




Boulton & Miniero        Expires March 29, 2010                [Page 33]


Internet-Draft          Media Resource Brokering          September 2009


<xsd:complexType name="mrbnotificationType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence
     <xsd:element ref="media-server-id" type="subscriptionid.datatype"/>
     <xsd:element ref="active-rtp-sessions" minOccurs="0" />
     <xsd:element ref="active-mixer-sessions" minOccurs="0" />
     <xsd:element ref="non-active-rtp-sessions" minOccurs="0" />
     <xsd:element ref="non-active-mixer-sessions" minOccurs="0" />
     <xsd:element ref="media-server-status" minOccurs="0" />
     <xsd:element ref="supported-codecs" minOccurs="0" />
     <xsd:element ref="application-data" minOccurs="0"
      maxOccurs="unbounded" />
     <xsd:element ref="file-formats" minOccurs="0" />
     <xsd:element ref="max-prepared-duration" minOccurs="0" />
     <xsd:element ref="announce-var" minOccurs="0" />
     <xsd:element ref="dtmf-support" minOccurs="0" />
     <xsd:element ref="mixing-modes" minOccurs="0" />
     <xsd:element ref="supported-tones" minOccurs="0" />
     <xsd:element ref="streaming-modes" minOccurs="0" />
     <xsd:element ref="asr-tts-support" minOccurs="0" />
     <xsd:element ref="vxml-support" minOccurs="0" />
     <xsd:element ref="media-server-location" minOccurs="0" />
     <xsd:element ref="label" minOccurs="0" />
     <xsd:element ref="media-server-address" minOccurs="0" />
     <xsd:element ref="encryption" minOccurs="0" />
     <xsd:any namespace="##other" minOccurs="0"
      maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
     <xsd:attribute name="id" type="subscriptionid.datatype"
      use="required" />
     <xsd:attribute name="seqnumber" type="xsd:nonNegativeInteger"
      use="required" />
     <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="mrbnotification" type="mrbnotificationType" />

<!--  active-rtp-sessions -->

 <xsd:complexType name="active-rtp-sessionsType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
      <xsd:element ref="rtp-codec" minOccurs="0"
        maxOccurs="unbounded" />



Boulton & Miniero        Expires March 29, 2010                [Page 34]


Internet-Draft          Media Resource Brokering          September 2009


       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

<xsd:element name="active-rtp-sessions" type="active-rtp-sessionsType"/>


 <xsd:complexType name="rtp-codecType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
      <xsd:element name="decoding" type="xsd:nonNegativeInteger" />
      <xsd:element name="encoding" type="xsd:nonNegativeInteger" />
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:attribute name="name" type="xsd:string" use="required" />
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="rtp-codec" type="rtp-codecType" />


<!--  active-mixer-sessions -->

<xsd:complexType name="active-mixer-sessionsType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
      <xsd:element ref="active-mix" minOccurs="0"
        maxOccurs="unbounded" />
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="active-mixer-sessions"
  type="active-mixer-sessionsType" />




Boulton & Miniero        Expires March 29, 2010                [Page 35]


Internet-Draft          Media Resource Brokering          September 2009


 <xsd:complexType name="active-mixType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
      <xsd:element ref="rtp-codec" minOccurs="0"
        maxOccurs="unbounded" />
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:attributeGroup ref="fw:framework-attributes" />
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="active-mix" type="active-mixType" />


<!--  non-active-rtp-sessions -->

<xsd:complexType name="non-active-rtp-sessionsType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
      <xsd:element ref="rtp-codec" minOccurs="0"
        maxOccurs="unbounded" />
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="non-active-rtp-sessions"
  type="non-active-rtp-sessionsType" />

<!--  non-active-mixer-sessions -->

<xsd:complexType name="non-active-mixer-sessionsType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
      <xsd:element ref="non-active-mix" minOccurs="0"
        maxOccurs="unbounded" />
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>



Boulton & Miniero        Expires March 29, 2010                [Page 36]


Internet-Draft          Media Resource Brokering          September 2009


    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="non-active-mixer-sessions"
  type="non-active-mixer-sessionsType" />

 <xsd:complexType name="non-active-mixType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
      <xsd:element ref="rtp-codec" />
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:attribute name="available" type="xsd:nonNegativeInteger"
      use="required" />
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="non-active-mix" type="non-active-mixType" />

<!--  media-server-status -->

 <xsd:element name="status" type="msstatus.datatype" />

<!--  supported-codecs -->

<xsd:complexType name="supported-codecsType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
       <xsd:element ref="supported-codec"
         minOccurs="0" maxOccurs="unbounded" />
       <xsd:any namespace="##other" minOccurs="0"
         maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="supported-codecs" type="supported-codecsType" />

 <xsd:complexType name="supported-codecType">



Boulton & Miniero        Expires March 29, 2010                [Page 37]


Internet-Draft          Media Resource Brokering          September 2009


  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
      <xsd:element ref="supported-codec-package"
         minOccurs="0" maxOccurs="unbounded" />
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:attribute name="name" type="xsd:string" use="required" />
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="supported-codec" type="supported-codecType" />

 <xsd:complexType name="supported-codec-packageType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
       <xsd:element name="supported-actions" type="actions.datatype"
        minOccurs="0" maxOccurs="unbounded" />
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:attribute name="name" type="xsd:string" use="required" />
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="supported-codec-package"
  type="supported-codec-packageType" />


<!--  application-data -->

<xsd:element name="application-data" type="appdata.datatype" />

<!--  file-formats -->

<xsd:complexType name="file-formatsType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
       <xsd:element ref="supported-format"
         minOccurs="0" maxOccurs="unbounded" />
       <xsd:any namespace="##other" minOccurs="0"



Boulton & Miniero        Expires March 29, 2010                [Page 38]


Internet-Draft          Media Resource Brokering          September 2009


         maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="file-formats" type="file-formatsType" />

 <xsd:complexType name="supported-formatType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
      <xsd:element ref="supported-file-package"
         minOccurs="0" maxOccurs="unbounded" />
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:attribute name="name" type="xsd:string" use="required" />
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="supported-format" type="supported-formatType" />

 <xsd:complexType name="supported-file-packageType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
       <xsd:element name="supported-file-package-name" type="xsd:string"
        minOccurs="0" maxOccurs="unbounded" />
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="supported-file-package"
  type="supported-file-packageType" />

<!--  max-prepared-duration -->

<xsd:complexType name="max-prepared-durationType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">



Boulton & Miniero        Expires March 29, 2010                [Page 39]


Internet-Draft          Media Resource Brokering          September 2009


    <xsd:sequence>
      <xsd:element ref="max-time" />
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="max-prepared-duration"
  type="max-prepared-durationType" />


 <xsd:complexType name="max-timeType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
      <xsd:element name="max-time-package" type="xsd:string" />
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:attribute name="max-time-seconds" type="xsd:nonNegativeInteger"
     use="required" />
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="max-time" type="max-timeType" />


<!--  announce-var -->

 <xsd:complexType name="announce-varType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
       <xsd:element ref="param" />
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="announce-var" type="announce-varType" />



Boulton & Miniero        Expires March 29, 2010                [Page 40]


Internet-Draft          Media Resource Brokering          September 2009


 <xsd:complexType name="paramType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
      <xsd:element name="param-value" type="xsd:NMTOKEN" />
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:attribute name="name" type="xsd:string" use="required" />
    <xsd:attribute name="package" type="xsd:string" use="required" />
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="param" type="paramType" />


<!--  dtmf-support -->

<xsd:complexType name="dtmf-supportType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
       <xsd:element ref="detect" />
       <xsd:element ref="generate" />
       <xsd:element ref="passthrough" />
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="dtmf-support" type="dtmf-supportType" />

 <xsd:complexType name="detectType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
       <xsd:element ref="dtmf-type"
        minOccurs="0" maxOccurs="unbounded" />
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>



Boulton & Miniero        Expires March 29, 2010                [Page 41]


Internet-Draft          Media Resource Brokering          September 2009


  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="detect" type="detectType" />

 <xsd:complexType name="generateType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
       <xsd:element ref="dtmf-type"
        minOccurs="0" maxOccurs="unbounded" />
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="generate" type="generateType" />

 <xsd:complexType name="passthroughType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
       <xsd:element ref="dtmf-type"
        minOccurs="0" maxOccurs="unbounded" />
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="passthrough" type="passthroughType" />


 <xsd:complexType name="dtmf-typeType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:attribute name="name" type="dtmf.datatype" use="required" />
    <xsd:attribute name="package" type="xsd:string" use="required" />
    <xsd:anyAttribute namespace="##other" processContents="lax" />



Boulton & Miniero        Expires March 29, 2010                [Page 42]


Internet-Draft          Media Resource Brokering          September 2009


   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="dtmf-type" type="dtmf-typeType" />


<!--  mixing-modes -->

    <!-- **** TODO **** -->

<!--  supported-tones -->

    <!-- **** TODO **** -->

<!--  streaming-modes -->

 <xsd:complexType name="stream-modesType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
      <xsd:element ref="stream-mode"
        minOccurs="0" maxOccurs="unbounded" />
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="stream-modes" type="stream-modesType" />

 <xsd:complexType name="stream-modeType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:attribute name="name" type="streammode.datatype"
     use="required" />
    <xsd:attribute name="package" type="xsd:string" use="required" />
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>




Boulton & Miniero        Expires March 29, 2010                [Page 43]


Internet-Draft          Media Resource Brokering          September 2009


 <xsd:element name="stream-mode" type="stream-modeType" />

<!--  asr-tts-support -->

 <!-- **** TODO **** -->

<!--  vxml-support -->

 <xsd:complexType name="vxml-supportType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
      <xsd:element ref="vxml-mode"
        minOccurs="0" maxOccurs="unbounded" />
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:attribute name="support" type="boolean.datatype"
     default="false" use="required" />
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="vxml-support" type="vxml-supportType" />

 <xsd:complexType name="vxml-modeType">
  <xsd:complexContent>
   <xsd:extension base="Tcore">
    <xsd:sequence>
       <xsd:any namespace="##other" minOccurs="0"
        maxOccurs="unbounded" processContents="lax" />
    </xsd:sequence>
    <xsd:attribute name="package" type="xsd:string" use="required" />
    <xsd:attribute name="support" type="vxml.datatype" use="required" />
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:extension>
  </xsd:complexContent>
 </xsd:complexType>

 <xsd:element name="vxml-mode" type="vxml-modeType" />

<!--  media-server-location -->

 <!-- **** TODO **** -->

<!--  label -->




Boulton & Miniero        Expires March 29, 2010                [Page 44]


Internet-Draft          Media Resource Brokering          September 2009


 <xsd:element name="label" type="label.datatype" />


<!-- media-server-address -->

 <xsd:element name="ms-address" type="xsd:anyURI" />

<!--  encryption -->

 <!-- **** TODO **** -->

<!--
  ####################################################

  DATATYPES

  ####################################################
 -->


 <xsd:simpleType name="version.datatype">
  <xsd:restriction base="xsd:NMTOKEN">
   <xsd:enumeration value="1.0" />
  </xsd:restriction>
 </xsd:simpleType>

<xsd:simpleType name="id.datatype">
  <xsd:restriction base="xsd:NMTOKEN" />
 </xsd:simpleType>

 <xsd:simpleType name="status.datatype">
  <xsd:restriction base="xsd:positiveInteger">
   <xsd:pattern value="[0-9][0-9][0-9]" />
  </xsd:restriction>
 </xsd:simpleType>

 <xsd:simpleType name="msstatus.datatype">
  <xsd:restriction base="xsd:NMTOKEN">
   <xsd:enumeration value="active" />
   <xsd:enumeration value="deactivated" />
   <xsd:enumeration value="unavailable" />
  </xsd:restriction>
 </xsd:simpleType>

 <xsd:simpleType name="actions.datatype">
  <xsd:restriction base="xsd:NMTOKEN">
   <xsd:enumeration value="encoding" />
   <xsd:enumeration value="decoding" />



Boulton & Miniero        Expires March 29, 2010                [Page 45]


Internet-Draft          Media Resource Brokering          September 2009


   <xsd:enumeration value="passthrough" />
  </xsd:restriction>
 </xsd:simpleType>

 <xsd:simpleType name="appdata.datatype">
  <xsd:restriction base="xsd:NMTOKEN" />
 </xsd:simpleType>

 <xsd:simpleType name="dtmf.datatype">
  <xsd:restriction base="xsd:NMTOKEN">
   <xsd:enumeration value="INFO" />
   <xsd:enumeration value="RFC4733" />
   <xsd:enumeration value="Media" />
  </xsd:restriction>
 </xsd:simpleType>

 <!-- *** TODO-Look at values **** -->
 <xsd:simpleType name="streammode.datatype">
  <xsd:restriction base="xsd:NMTOKEN">
   <xsd:enumeration value="RTSP" />
   <xsd:enumeration value="HTTP" />
   <xsd:enumeration value="NFS" />
  </xsd:restriction>
 </xsd:simpleType>

 <xsd:simpleType name="boolean.datatype">
  <xsd:restriction base="xsd:NMTOKEN">
   <xsd:enumeration value="true" />
   <xsd:enumeration value="false" />
  </xsd:restriction>
 </xsd:simpleType>

  <xsd:simpleType name="vxml.datatype">
  <xsd:restriction base="xsd:NMTOKEN">
   <xsd:enumeration value="RFC5552" />
   <xsd:enumeration value="IVR-Package" />
  </xsd:restriction>
 </xsd:simpleType>

 <xsd:simpleType name="label.datatype">
  <xsd:restriction base="xsd:NMTOKEN" />
 </xsd:simpleType>

</xsd:schema>



                                 Figure 9



Boulton & Miniero        Expires March 29, 2010                [Page 46]


Internet-Draft          Media Resource Brokering          September 2009


7.  Media Service Resource Consumer Interface XML Schema

   This section gives the XML Schema Definition [W3C.REC-xmlschema-1-
   20041028], [W3C.REC-xmlschema-2-20041028] of the "application/
   mrb-consumer+xml" format.


   <?xml version="1.0"?>

   <xsd:schema
     targetNamespace="urn:ietf:params:xml:ns:mediactrl:mrb"
     xmlns:xsd="http://www.w3.org/2001/XMLSchema"
     xmlns:mrb="urn:ietf:params:xml:ns:mediactrl:mrb"
     xmlns:xml="http://www.w3.org/XML/1998/namespace"
     elementFormDefault="qualified"
     attributeFormDefault="unqualified">

   <xsd:import namespace="http://www.w3.org/XML/1998/namespace"
              schemaLocation="http://www.w3.org/2001/xml.xsd"/>
   <xsd:element name="mrb-message" type="mrb-message-type" />

    <xsd:complexType name="mrb-message-type">
     <xsd:sequence>
     <xsd:choice>
      <xsd:element name="mediaResourceRequest"
                type="mrb:mediaResourceRequestType"/>
      <xsd:element name="mediaResourceResponse"
                type="mrb:mediaResourceResponseType"/>
      <xsd:element name="mediaResourceError"
                type="mrb:mediaResourceErrorType"/>
      <xsd:any namespace="##other" minOccurs="0"
                maxOccurs="unbounded" processContents="lax" />

     </xsd:choice>
    </xsd:sequence>
    <xsd:anyAttribute namespace="##other" processContents="lax" />
   </xsd:complexType>

   <xsd:complexType name="mediaResourceRequestType">
     <xsd:complexContent>
         <xsd:sequence>
          <xsd:any namespace="##other" minOccurs="0"
                maxOccurs="unbounded" processContents="lax" />
         </xsd:sequence>
         <xsd:anyAttribute namespace="##other" processContents="lax" />
     </xsd:complexContent>
   </xsd:complexType>




Boulton & Miniero        Expires March 29, 2010                [Page 47]


Internet-Draft          Media Resource Brokering          September 2009


   <xsd:complexType name="mediaResourceResponseType">
     <xsd:complexContent>
         <xsd:sequence>
            <xsd:any namespace="##other" minOccurs="0"
                maxOccurs="unbounded" processContents="lax" />
         </xsd:sequence>
         <xsd:anyAttribute namespace="##other" processContents="lax" />
     </xsd:complexContent>
   </xsd:complexType>

   <xsd:complexType name="mediaResourceErrorType">
     <xsd:complexContent>
         <xsd:choice minOccurs="0" maxOccurs="unbounded">
           <xsd:any namespace="##other" processContents="strict"/>
         </xsd:choice>
         <xsd:attribute name="status" type="status.datatype"
               use="required"/>
         <xsd:anyAttribute namespace="##other" processContents="lax" />
     </xsd:complexContent>
   </xsd:complexType>

    <!-- DATATYPES -->

   <xsd:simpleType name="status.datatype">
     <xsd:restriction base="xsd:NMTOKEN">
      <xsd:pattern value="[0-9][0-9][0-9]"/>
     </xsd:restriction>
    </xsd:simpleType>
         </xsd:complexContent>
   </xsd:complexType>

   </xsd:schema>


                                 Figure 10
















Boulton & Miniero        Expires March 29, 2010                [Page 48]


Internet-Draft          Media Resource Brokering          September 2009


8.  Security Considerations

   Security Considerations to be included in later versions of this
   document.















































Boulton & Miniero        Expires March 29, 2010                [Page 49]


Internet-Draft          Media Resource Brokering          September 2009


9.  IANA Considerations

   IANA Considerations to be included in later versions of this
   document.















































Boulton & Miniero        Expires March 29, 2010                [Page 50]


Internet-Draft          Media Resource Brokering          September 2009


10.  Changes

   Note to RFC Editor: Please remove this whole section.

10.1.  Changes from 01 Version

   o  Included In-line text based on strawman proposal.

   o  Included first attempt at publish interface based on design team
      work.









































Boulton & Miniero        Expires March 29, 2010                [Page 51]


Internet-Draft          Media Resource Brokering          September 2009


11.  Acknowledgments

   The authors would like to thank the members of the Publish Interface
   design team who provided valuable input into this document.  The
   design team consisted of Gary Munson, Adnan Saleem, Michael Trank,
   Victor Paulsamy, Martin Dolly, and Scott McGlashan.













































Boulton & Miniero        Expires March 29, 2010                [Page 52]


Internet-Draft          Media Resource Brokering          September 2009


12.  References

12.1.  Normative References

   [RFC2046]  Freed, N. and N. Borenstein, "Multipurpose Internet Mail
              Extensions (MIME) Part Two: Media Types", RFC 2046,
              November 1996.

   [RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
              Requirement Levels", BCP 14, RFC 2119, March 1997.

   [RFC2578]  McCloghrie, K., Ed., Perkins, D., Ed., and J.
              Schoenwaelder, Ed., "Structure of Management Information
              Version 2 (SMIv2)", STD 58, RFC 2578, April 1999.

   [RFC2579]  McCloghrie, K., Ed., Perkins, D., Ed., and J.
              Schoenwaelder, Ed., "Textual Conventions for SMIv2",
              STD 58, RFC 2579, April 1999.

   [RFC2580]  McCloghrie, K., Perkins, D., and J. Schoenwaelder,
              "Conformance Statements for SMIv2", STD 58, RFC 2580,
              April 1999.

   [RFC2616]  Fielding, R., Gettys, J., Mogul, J., Frystyk, H.,
              Masinter, L., Leach, P., and T. Berners-Lee, "Hypertext
              Transfer Protocol -- HTTP/1.1", RFC 2616, June 1999.

   [RFC2818]  Rescorla, E., "HTTP Over TLS", RFC 2818, May 2000.

   [RFC3261]  Rosenberg, J., Schulzrinne, H., Camarillo, G., Johnston,
              A., Peterson, J., Sparks, R., Handley, M., and E.
              Schooler, "SIP: Session Initiation Protocol", RFC 3261,
              June 2002.

   [RFC3410]  Case, J., Mundy, R., Partain, D., and B. Stewart,
              "Introduction and Applicability Statements for Internet-
              Standard Management Framework", RFC 3410, December 2002.

   [W3C.CR-wsdl20-20051215]
              Chinnici, R., Moreau, J., Ryman, A., and S. Weerawarana,
              "Web Services Description Language (WSDL) Version 2.0 Part
              1: Core Language", W3C CR CR-wsdl20-20051215,
              December 2005.

   [W3C.REC-soap12-part1-20030624]
              Hadley, M., Gudgin, M., Mendelsohn, N., Moreau, J., and H.
              Nielsen, "SOAP Version 1.2 Part 1: Messaging Framework",
              World Wide Web Consortium FirstEdition REC-soap12-part1-



Boulton & Miniero        Expires March 29, 2010                [Page 53]


Internet-Draft          Media Resource Brokering          September 2009


              20030624, June 2003,
              <http://www.w3.org/TR/2003/REC-soap12-part1-20030624>.

   [W3C.REC-soap12-part2-20030624]
              Hadley, M., Mendelsohn, N., Gudgin, M., Moreau, J., and H.
              Nielsen, "SOAP Version 1.2 Part 2: Adjuncts", World Wide
              Web Consortium FirstEdition REC-soap12-part2-20030624,
              June 2003,
              <http://www.w3.org/TR/2003/REC-soap12-part2-20030624>.

12.2.  Informative References

   [I-D.ietf-mediactrl-architecture]
              Melanchuk, T., "An Architectural Framework for Media
              Server Control", draft-ietf-mediactrl-architecture-04
              (work in progress), November 2008.

   [I-D.ietf-mediactrl-requirements]
              Dolly, M. and R. Even, "Media Server Control Protocol
              Requirements", draft-ietf-mediactrl-requirements-04 (work
              in progress), February 2008.

   [I-D.ietf-mediactrl-sip-control-framework]
              Boulton, C., Melanchuk, T., and S. McGlashan, "Media
              Control Channel Framework",
              draft-ietf-mediactrl-sip-control-framework-10 (work in
              progress), February 2009.
























Boulton & Miniero        Expires March 29, 2010                [Page 54]


Internet-Draft          Media Resource Brokering          September 2009


Authors' Addresses

   Chris Boulton
   NS-Technologies

   Email: chris@ns-technologies.com


   Lorenzo Miniero
   University of Napoli

   Email: lorenzo.miniero@unina.it







































Boulton & Miniero        Expires March 29, 2010                [Page 55]