Share via


OMA DM Protocol Command Elements

Send Feedback

This section lists the OMA DM Command elements that are used to manage Windows Mobile-based devices. For each command element a short description and any information specific to its implementation for Windows Mobile Version 5.0 are included. For further information OMA DM Command Elements see "SyncML Representation Protocol Device Management Usage (OMA-SyncML-DMRepPro-V1_1_2-20030613-A)" it is available from this OMA website

Note   If an XML element is not a valid OMA DM command then the status code 400 is returned for that element.

The following table shows the OMA DM Command Elements that are used in Windows Mobile-based devices.

Command Element Description
Add OMA Command Element Creates a new node in the DM tree. Windows Mobile Version 5.0 supports Implicit Add which means that interior nodes specified in the Target LocURI will be added if they don't already exist.

The following example shows how to use the Add command. In this example b1 is to be added to be tree as a child node of interior node B. c1 is the data value of node b1. Because b1 is not currently in the device's DM tree, this node will be automatically created.

<Add> 
  <CmdID>...</CmdID> 
  <Item> 
    <Meta> 
     <Format xmlns='syncml:metinf'>...</Format> 
     <Type xmlns='syncml:metinf'>....</Type> 
    </Meta> 
    <Target> 
      <LocURI>Vendor/A/B/b1</LocURI> 
    </Target> 
    <Data>c1</Data>
  </Item> 

</Add>

Alert (DM Alert) OMA Command Element Sends notifications, such as device management session requests, to the recipient.
Atomic OMA Command Element Indicates that the client device must process a specified group of OMA DM commands together or not at all.
Note   Performing an Add command followed by Replace on the same node within an Atomic element is not supported in Windows Mobile Version 5.0.
Delete OMA Command Element Removes a node from the DM tree, and the entire sub-tree beneath that node if one exists.
Exec OMA Command Element Invokes an executable on the client device.
Get OMA Command Element Retrieves data from the client device.
Replace OMA Command Element Overwrites data on the client device.
Results OMA Command Element Returns the data results of either a Get or Search command to the DM server.
Sequence OMA Command Element Specifies the order in which a group of commands must be processed.
Status OMA Command Element Indicates the completion status (success or failure) of an operation.

See Also

OMA Device Management Provisioning | Configuration Service Provider Reference for Windows Mobile-Based Devices

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.