Send XML Settings

The “Send XML Settings” Document provides greater flexibility for the sending out of custom XML Settings documents, above and beyond the XML that can be generated by the various OTA web forms of NowSMS.

The “Send XML Settings Document” interface supports the following types of XML settings documents:

Nokia/Ericsson Over The Air Settings (OTA) Specification up to and including v7.1

Browser and MMS settings use the root XML element <CHARACTERISTIC-LIST>

SyncML settings use the root XML element <SyncSettings>

Wireless Village/IMPS settings use the root XML element <WVSettings>

Examples of this format can be generated using the Send WAP OTA Settings web form.

Copies of the specification that documents these settings can be downloaded from either the Nokia or SonyEricsson developer web sites.

OMA (Open Mobile Alliance) Provisioning Content

All settings use the root XML element <wap-provisioningdoc>

Examples of this format can be generated using the Send OMA Settings web form.

The OMA Provisioning Content Specification is available for download from the Open Mobile Alliance web site at http://www.openmobilealliance.org.

OMA (Open Mobile Alliance) DRM Rights Objects

The objects use the root XML element <o-ex:rights>.

The DRMCOMP utility can be used to generate DRM rights objects. For additional information, refer to Digital Rights Management.

The OMA DRM Right Expression Language specification can be downloaded from the Open Mobile Alliance web site at http://www.openmobilealliance.org.

NowSMS also supports ROAP Trigger messages (root XML element <roap:roapTrigger>) as defined in the OMA DRM 2.1 specification.

WAP Push Service Indication, Service Load and Cache Operation

The operations use the root XML element <si>, <sl> or <co>.

These formats are defined in the WAP Service Indication (WAP-167), Service Load (WAP-168), and Cache Operation (WAP-175) specifications respectively.

These specifications can all be downloaded from the Open Mobile Alliance web site at http://www.openmobilealliance.org.

OMA (Open Mobile Alliance) E-Mail Notification (EMN)

This format uses the root XML element <emn>.

The OMA E-Mail Notification specification can be downloaded from the Open Mobile Alliance web site at http://www.openmobilealliance.org.

OTA PIN and OTA PIN Type

An “OTA PIN” can be associated with an OMA Provisioning Content message, in addition to some other settings message types, to provide a layer of authentication to the message. Many devices will allow you to send OTA settings without a PIN, but some will require a PIN to be present before the settings will be accepted.

There are three different types of OTA PINs, depending on the “OTA PIN Type” setting.

  1. The simplest “OTA PIN Type” is “User PIN” (USERPIN). This setting indicates that a short PIN code (often 4 digits) is supplied as the “OTA PIN”. When the user receives the OTA settings message, they will need to supply this PIN code in order to be able to open the message and apply the settings.
  2. “Network PIN” (NETWPIN) indicates the PIN is a network PIN code. In the GSM environment, this is the IMSI number associated with the SIM card in the device. (Hint, if you want to experiment with determining the PIN card associated with a SIM, you can put the SIM into a GSM modem and the AT+CIMI command to return the IMSI. However, not all GSM modems support the AT+CIMI command.) When the device receives the settings, if the NETWPIN does not match the IMSI, the settings will be discarded.
  3. An additional type of PIN, known as “USERNETWPIN” also exists, which indicates a combination of the USERPIN and NETWPIN types. To use this OTA PIN type, select “Network PIN”, and define the OTA PIN as the IMSI number associated with the SIM card in the device, followed by a “:” character, followed by a USERPIN (e.g., 1234567889012345:1234). When the device receives the settings, the user will be prompted for a PIN. This user supplied PIN, and the SIM card IMSI, must match in order for the settings to be accepted.

Use the “Submit” button to send the settings.