CMPLANNER Configuration Service Provider

Send Feedback

The CMPLANNER Configuration Service Provider configures the preferred connections for each network. These preferred connections are used by the Connection Manager. This Configuration Service Provider can also set the settings for those connections.

Note   This Configuration Service Provider is a proprietary extension of the OMA DM protocol, and must be used when provisioning devices using OMA DM. To provision devices using the OMA Client Provisioning (formerly WAP) protocol, use the CM_Planner Configuration Service Provider instead.
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 Roles and Default Roles for Configuration Service Providers.

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

CMPLANNER
The root node for CMPLANNER object. The following table shows the default settings.
Format Node
Roles allowed to query and update setting Manager

AuthenticatedUser

Access Type Read/Write
Occurs Once
CMPLANNER/CacheTime
Specifies the default time, in seconds, for which the planner will cache released connections. The following table shows the possible values.
Value Description
0 None
30 30 seconds
60 1 minute
300 5 minutes
600 10 minutes

The following table shows the default settings.

Format Integer
Label Idle disconnect after:
Roles allowed to query and update setting Manager

AuthenticatedUser

The Connection Manager does not cache the following types of connections:

  • Suspended connections
  • Disconnected connections
  • Connections without a DestId (that is, when the connection was provisioned using provisioning XML, a DestId was not specified)
  • Fixed path connections (that is, a connection where the destination GUID is set to be an existing network connection managed using the Connection Manager)

Caching also does not occur when ConnMgrReleaseConnection is called with the lCache parameter set to 0.

CMPLANNER/CoeffBandwidth
Specifies a bandwidth coefficient, in 16.16 fixed point, for planner path calculations. The default value is 0x10000, which corresponds to 1.0.

The following table shows the default settings.

Format Integer
Label Bandwidth Coefficient
Roles allowed to query and update setting Manager

AuthenticatedUser

CMPLANNER/CoeffCost
Specifies a cost coefficient, in 16.16 fixed point, for planner path calculations. The default value is 0x10000, which corresponds to 1.0.

The following table shows the default settings.

Format Integer
Label Cost Coefficient
Roles allowed to query and update setting Manager

AuthenticatedUser

CMPLANNER/CoeffLatency
Specifies a latency coefficient, in 16.16 fixed point, for planner path calculations. The default value is 0x10000, which corresponds to 1.0.

The following table shows the default settings.

Format Integer
Label Latency Coefficient
Roles allowed to query and update setting Manager

AuthenticatedUser

CMPLANNER/FailoverDefault
Sets the default value for the yes/no buttons of the failover prompt. Permitted values are 0 (no) or 1 (yes).
Note   The prompt has an internal timeout, so this also controls the default action if the user does not respond to the prompt within the time limit. If the failover prompt is disabled, this parameter also specifies whether failover is allowed.

The following table shows the default settings.

Format Boolean
Roles allowed to query and update setting Manager

AuthenticatedUser

CMPLANNER/FailoverPrompt
Specifies whether the planner displays a yes/no prompt before using a non-preferred connection, for example if the preferred connection is unavailable. The following table shows the possible values.
Value Description
0 Do not display a prompt
1 Display a prompt

The following table shows the default settings.

Format Boolean
Roles allowed to query and update setting Manager

AuthenticatedUser

CMPLANNER/RetryCount
Specifies the number of times the planner retries failed connection attempts. Possible values for this parameter are 0, 1, 2, 3, 4 and 5. A value of 0 causes the planner to fail the connection attempt after the first try. A value of 1 causes the planner to retry the connection once.

The following table shows the default settings.

Format Integer
Label Redial attempts:
Roles allowed to query and update setting Manager

AuthenticatedUser

CMPLANNER/PreferredConnections
Specifies the preferred connection to use when connecting to a specific destination network.

The following table shows the default settings.

Format Node
Roles allowed to query and update setting Manager

AuthenticatedUser

CMPLANNER/PreferredConnections/Internet
Specifies the preferred connection to use when connecting to the Internet. The value must be the entry name of a connection, which may be the initial node on a path connecting the device to the specified destination network.

The following table shows the default settings.

Format String
Label Internet connection:
Roles allowed to query and update setting Manager

AuthenticatedUser

CMPLANNER/PreferredConnections/Work
Specifies the preferred connection to use when connecting to the Work metanetwork. The value must be the entry name of a connection, which may be the initial node on a path connecting the device to the specified destination network.

The following table shows the default settings.

Format String
Label Work connection:
Roles allowed to query and update setting Manager

AuthenticatedUser

CMPLANNER/PreferredConnections/WAP
Specifies the preferred connection to use when connecting to a WAP network. The value must be the entry name of a connection, which may be the initial node on a path connecting the device to the specified destination network.

The following table shows the default settings.

Format String
Label WAP connection:
Roles allowed to query and update setting Manager

AuthenticatedUser

CMPLANNER/PreferredConnections/SecureWAP
Specifies the preferred connection to use when connecting to a WAP network. The value must be the entry name of a connection, which may be the initial node on a path connecting the device to the specified destination network.

The following table shows the default settings.

Format String
Label Secure WAP connection:
Roles allowed to query and update setting Manager

AuthenticatedUser

-See Also

Configuration Service Provider Reference for Windows Mobile-Based Devices | CMPLANNER Configuration Service Provider Example for OMA DM | CM_Planner Configuration Service Provider


Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.


Show: