Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

The Clock Configuration Service Provider is used to configure the local time zones, and system alarm settings. It sets the time zone, the alarm time and whether the alarm is on or off.

When you set the Alarm or Clock using a provisioning XML file, the Clock Configuration Service Provider expects you to provide the full date/time string in ISO 8601 standard date/time format:

[YYYY]-[MM]-[DD]T[hh]:[mm]:[ss]

For example, 2005-10-04T13:45:59Zrepresents 4 October 2005 at 1:45:59 PM. The 'Z' specifies Coordinated Universal Time (also known as UTC or Zulu time), which uses the 24-hour numbering system.

Note:
This Configuration Service Provider is supported by the OMA Client Provisioning (formerly WAP Client Provisioning) protocol.
Note:
Access to this Configuration Service Provider is determined by Security roles. Because OEMs and Mobile Operators can selectively disallow access, ask them about the availability of this Configuration Service Provider. For more information about roles, see Security Rolesand Default Roles for Configuration Service Providers.

The following image shows the management object used by OMA DM.

The following image shows the Configuration Service Provider in tree format as used by OMA Client Provisioning.

The Clock Configuration Service Provider is available on Windows Mobile Professional and Windows Mobile Classic as of Windows Mobile 6.1. However, on these platforms, this Configuration Service Provider supports only the Date and Time settings ( Date, Time, and TimeZone), and does not support the Alarm settings ( AlarmOn, AlarmOn2, AlarmTime, AlarmTime2, and AlarmTimeout).

Characteristics

Only the root characteristic is available.

Parameters

AlarmOn

Determines the state of the first system alarm ( Alarm 1). The following table lists the possible values:

Value Description

0

Turns off the alarm

1

Turns on the alarm (every day)

2

Turns on the alarm (weekdays only)

3

Turns on the alarm (weekends only)

The following table shows the default settings.

Permissions

Read/Write

Data type

Integer

Label

Alarm 1:

Semantic type

Short-date time

Roles allowed to query and update setting

Manager

AuthenticatedUser

This setting is not available on Windows Mobile Professional and Windows Mobile Classic.

AlarmOn2

Determines the state of the second system alarm ( Alarm 2). This parameter has the same syntax and default values as AlarmOn, except that the default value of Labelis 'Alarm 2:'.

This setting is not available on Windows Mobile Professional and Windows Mobile Classic.

AlarmTime

Sets the alarm time for the first system alarm ( Alarm 1). The following table shows the default settings:

Permissions

read/write

Data type

time

Label

Alarm 1 time:

Semantic type

short-date time

Roles allowed to query and update setting

Manager

AuthenticatedUser

Value

GMT time format; a leading 0 is required if the hour is less than 10. For example, 06:00:00Z. Alarm time will be adjusted to the time zone set on the device.

This setting is not available on Windows Mobile Professional and Windows Mobile Classic.

AlarmTime2

Sets the alarm time for the second system alarm ( Alarm 2). This parameter has the same syntax and default values as AlarmTime, except that the default value of Labelis 'Alarm 2 time:'.

This setting is not available on Windows Mobile Professional and Windows Mobile Classic.

AlarmTimeout

Specifies the interval, in minutes, after which the alarm reminder will be automatically dismissed. If this DWORD value is 0, or is not present, the alarm will have no timeout.

This setting corresponds to the AlarmTimeoutregistry setting .

This setting is not available on Windows Mobile Professional and Windows Mobile Classic.

Date

Specifies the system date information. The following table shows the default settings:

Permissions

Read/write

Data type

String

Roles allowed to query and update setting

Manager

Operator

Operator TPS

AuthenticatedUser

Time

Specifies the system time information. The following table shows the default settings:

Permissions

Read/write

Data type

String

Roles allowed to query and update setting

Manager

Operator

Operator TPS

AuthenticatedUser

TimeZone

Sets the current time zone on the system. The following table lists the possible values:

Value Description

0

GMT-12 Kwajalein

1

GMT-11 Samoa, Midway

2

GMT-10 Hawaii

3

GMT-9 Alaska

4

GMT-8 Pacific US

10

GMT-7 Mountain US

13

GMT-7 Chihuahua, La Paz

15

GMT-7 Arizona

20

GMT-6 Central US

25

GMT-6 Saskatchewan

30

GMT-6 Mexico City, Monterrey

33

GMT-6 Central America

35

GMT-5 Eastern US

40

GMT-5 Indiana (USA)

45

GMT-5 Bogota, Lima

50

GMT-4 Atlantic

55

GMT-4 Caracas, La Paz

56

GMT-4 Santiago

60

GMT-3:30 Newfoundland

65

GMT-3 Brasilia

70

GMT-3 Buenos Aires

73

GMT-3 Greenland

75

GMT-2 Mid-Atlantic

80

GMT-1 Azores

83

GMT-1 Cape Verde

85

GMT London, Dublin

90

GMT Casablanca

95

GMT+1 Prague, Budapest

100

GMT+1 Warsaw, Sofija

105

GMT+1 Paris, Madrid

110

GMT+1 Berlin, Rome

113

GMT+1 West Central Africa

115

GMT+2 Bucharest

120

GMT+2 Cairo

125

GMT+2 Helsinki, Riga

130

GMT+2 Athens, Istanbul

135

GMT+2 Jerusalem

140

GMT+2 Pretoria

145

GMT+3 Moscow

150

GMT+3 Riyadh, Kuwait

155

GMT+3 Nairobi

158

GMT+3 Baghdad

160

GMT+3:30 Tehran

165

GMT+4 Abu Dhabi

170

GMT+4 Baku, Tbilisi

175

GMT+4:30 Kabul

180

GMT+5 Yekaterinburg

185

GMT+5 Islamabad

190

GMT+5:30 New Delhi

193

GMT+5:45 Kathmandu

195

GMT+6 Astana, Dhaka

200

GMT+6 Sri Lanka

201

GMT+6 Almaty

203

GMT+6:30 Yangoon

205

GMT+7 Bangkok, Hanoi

207

GMT+7 Krasnoyarsk

210

GMT+8 Beijing, Hong Kong

215

GMT+8 Malaysia, Singapore

220

GMT+8 Taipei

225

GMT+8 Perth

227

GMT+8 Ulaanbataar

230

GMT+9 Seoul

235

GMT+9 Tokyo, Osaka

240

GMT+9 Yakutsk

245

GMT+9:30 Darwin

250

GMT+9:30 Adelaide

255

GMT+10 Sydney

260

GMT+10 Brisbane

265

GMT+10 Hobart

270

GMT+10 Vladivostok

275

GMT+10 Guam

280

GMT+11 Magadan

285

GMT+12 Fiji Islands

290

GMT+12 New Zealand

300

GMT+13 Tonga

The following table shows the default settings:

Permissions

Read/Write

Data type

Integer

Label

Time zone:

Roles allowed to query and update setting

Manager

Operator

Operator - TPS

AuthenticatedUser

Microsoft Custom Elements

The following table shows the Microsoft custom elements that this Configuration Service Provider supports for OMA Client Provisioning.

Elements Available

parm-query

Yes

noparm

No

nocharacteristic

No

characteristic-query

No

Use these elements to build standard OMA Client Provisioning (formerly WAP Client Provisioning) configuration XML. For information about specific elements, see MSPROV DTD Elements. For examples of how to generally use the Microsoft custom elements, see OMA Client Provisioning XML File Examples.

For information about OMA Client Provisioning, see OMA Client Provisioning Files.

See Also