OMA DM Provisioning Files

4/8/2010

OMA DM commands are transmitted between the server and the client device in messages. A message can contain one or more commands. For a list of commands supported in Windows Mobile 6.5, see OMA DM Protocol Command Elements.

A DM message is an XML document. The structure and content of the document is defined in the OMA DM Representation Protocol (OMA-SyncML-DevInfo-DTD-V1_1_2-20030505-D.dtd) available from the OMA Web site.

Each message is composed of a header, specified by the SyncHdr element, and a message body, specified by the SyncBody element.

The following table shows the OMA DM versions that are supported in Windows Mobile:

Version Format

OMA DM version 1.1.2

<SyncML xmlns='SYNCML:SYNCML1.1'>

</SyncML>

OMA DM version 1.2

<SyncML xmlns='SYNCML:SYNCML1.2'>

</SyncML>

File Format

The following example shows the general structure of the XML document, using OMA DM version 1.2 for demonstration purposes only.

<SyncML xmlns='SYNCML:SYNCML1.2'>
   <SyncHdr>
    <VerDTD>1.2</VerDTD>
    <VerProto>DM/1.2</VerProto>
    <SessionID>1</SessionID>
    <MsgID>1</MsgID>
    <Target>
        <LocURI>{unique device ID}</LocURI>
    </Target>
    <Source>
        <LocURI>https://www.thephone-company.com/mgmt-server</LocURI>
    </Source>
</SyncHdr>
   <SyncBody>
        <!-- change a registry settings -->
        <Replace>
            <CmdID>2</CmdID>
            <Item>
                <Target>
                    <LocURI>./Vendor/MSFT/Registry/SampleKey</LocURI>
                </Target>
                <Data>16</Data>
            </Item>
        </Replace>
        <Final />
</SyncBody>
</SyncML> 

For more information about the header and body, see SyncHdr and SyncBody.

See Also

Concepts

SyncHdr
SyncBody

Other Resources

Provisioning Using OMA Device Management