DUSM schema

The Data Usage Subscription Management (DUSM) schema defines elements that are used to describe cost information for a subscriber's connection to a metered network. All of the elements are in the namespace http://www.microsoft.com/networking/CarrierControl/DUSM/v1. Not all elements are in every profile, as some elements are optional.

The following table lists all of the elements in this schema, sorted alphabetically by name.

Element Description
BandwidthInKbps

Defines a value representing the effective link speed of the subscriber’s connection specified in Kbps. Must be a value from 0 to 232nd.

BillingCycle

Defines the plan's starting date and time, its duration, and what happens at the end of the billing cycle.

CarrierPolicy

Defines optional setting for Windows on this connection.

Cost

Defines a set of meter cost information that specifies the metered state of a subscriber's connection to a Mobile Network Operator (MNO). Cost is the unique root element for DUSM cost information.

DataLimitInMegabytes

Defines a value representing the data limit in MB for a capped plan. Must be a value from 0 to 232nd.

MaxDownloadFileSizeInMegabytes

Defines a value representing the maximum suggested download size in MB of the subscriber's connection. Must be a value from 0 to 232nd.

SecurityUpdatesExempt

If true, the MNO advises Windows Update (WU) that security updates are exempt from being counted as data usage against the subscriber’s plan and WU will download all security patches when on a metered network. Otherwise, WU will only download zero-day patches and not all security updates when false.

UsageInMegabytes

Defines a value representing the data used to-date within the current billing cycle in MB. Must be a value from 0 to 232nd.

UserSMSEnabled

Indicates whether the subscriber's service includes user-to-user SMS which must be delivered in near real-time. If true, Windows will employ less aggressive power management on the Mobile Broadband interface to allow SMS messages to arrive more quickly. If false, SMS messages will arrive when the PC is next active.

 

The full DUSM schema is below:

<?xml version="1.0" encoding="utf-8"?>
<xs:schema targetNamespace="http://www.microsoft.com/networking/CarrierControl/DUSM/v1"
    elementFormDefault="qualified"
    xmlns="http://www.microsoft.com/networking/CarrierControl/DUSM/v1"
    xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:simpleType name="PlanType">
    <xs:restriction base="xs:string">
      <xs:enumeration value="Unrestricted"/>
      <xs:enumeration value="Fixed"/>
      <xs:enumeration value="Variable"/>
    </xs:restriction>
  </xs:simpleType>

  <xs:complexType name="Subscription">
    <xs:sequence>
      <xs:element name="UsageInMegabytes" minOccurs="0">
        <xs:complexType>
          <xs:simpleContent>
            <xs:extension base="xs:nonNegativeInteger">
              <xs:attribute name="Timestamp" type="xs:dateTime" use="required"/>
            </xs:extension>
          </xs:simpleContent>
        </xs:complexType>
      </xs:element>
      <xs:element name="DataLimitInMegabytes" type="xs:positiveInteger" minOccurs="0"/>

      <xs:element name="BillingCycle" minOccurs="0">
        <xs:complexType>
          <xs:attribute name="StartDate" type="xs:dateTime" use="required"/>
          <xs:attribute name="Duration" use="required">
            <xs:simpleType>
              <xs:restriction base="xs:duration">
                <xs:minExclusive value="PT0S"/>
              </xs:restriction>
            </xs:simpleType>
          </xs:attribute>
          <xs:attribute name="Resets" type="xs:boolean" default="true"/>
        </xs:complexType>
      </xs:element>
      <xs:element name="BandwidthInKbps" type="xs:nonNegativeInteger" minOccurs="0"/>

      <xs:element name="MaxDownloadFileSizeInMegabytes" type="xs:positiveInteger" default="25" minOccurs="0"/>
      
      <xs:element name="CarrierPolicy" minOccurs="0">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="SecurityUpdatesExempt" type="xs:boolean" default="false" minOccurs="0"/>
            <xs:element name="UserSMSEnabled" type="xs:boolean" default="true" minOccurs="0"/>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
    </xs:sequence>
    <xs:attribute name="OverDataLimit" type="xs:boolean"/>
    <xs:attribute name="Congested" type="xs:boolean"/>
    <xs:attribute name="PlanType" use="required" type="PlanType"/>
  </xs:complexType>
  <xs:element name="Cost" type="Subscription"/>
</xs:schema>