PXLOGICAL Configuration Service Provider

4/8/2010

The PXLOGICAL Configuration Service Provider adds, removes, and modifies WAP logical and physical proxies by using WAP or the standard Windows Mobile device techniques. For more information, see the Update Standard WAP Connectivity Parameters.

The following table shows the default settings for all parameters in this Configuration Service Provider. The default security role maps to each subnode unless specific permission is granted to the subnode.

The following image shows the Configuration Service Provider in tree format as used by OMA Client Provisioning for initial bootstrapping of the device.

The following image shows the Configuration Service Provider in tree format as used by OMA Client Provisioning for updating the bootstrapping of the device.

Characteristics

• PORT
  This characteristic defines the binding between a port number and one or more protocols or services. This Configuration Service Provider can accept a maximum of two ports per physical proxy. A query of this characteristic returns information relating only to the first port.

• PXPHYSICAL
  This characteristic groups files for a physical proxy. One PXLOGICAL characteristic can contain multiple PXPHYSICAL characteristics.

Parameters

• BASAUTH-ID
  This parameter can be used in all PXLOGICAL characteristics. It contains the user ID of the start page. Query of this parameter is not supported.

• BASAUTH-PW
  This parameter can be used in all PXLOGICAL characteristics. It contains the user password of the start page. Query of this parameter is not supported.

• DOMAIN
  This parameter is used in the PXLOGICAL and PXPHYSICAL characteristics. A query of this parameter returns a semicolon delimited string of all domains.

• NAME
  This parameter can be used in all PXLOGICAL characteristics. It contains the name of the proxy.

  Note

  The NAME parameter in PXLOGICAL is displayed in one line to the user; the length of this parameter should be short for readability.

• PHYSICAL-PROXY-ID
  This parameter is used in the PXPHYSICAL characteristic to identify the physical proxy.

  Note

  The PHYSICAL-PROXY-ID parameter is displayed in one line to the user; the length of this parameter should be short for readability.

• PORTNBR
  This parameter is used in the PXLOGICAL\PORT and PXPHYSICAL\PORT characteristics to identify the port number associated with some services on this proxy.

• PROXY-ID
  This parameter can be used in all PXLOGICAL characteristics. It contains the unique identification of the logical proxy.

• PUSHENABLED
  This parameter is used in the PXLOGICAL and PXPHYSICAL characteristics to determine whether or not push operations are enabled. If the parameter is used in PXLOGICAL, it applies to all of the PXPHYSICAL characteristics embedded in the PXLOGICAL characteristic. A value of zero (0) indicates that the proxy does not support push operations. A value of 1 indicates that the proxy supports push operations.

• PXADDR
  This parameter is used in the PXPHYSICAL characteristic to identify the address of the physical proxy.

• PXADDRTYPE
  This parameter is used in the PXPHYSICAL characteristic to determine the address type for PXADDR. Only E164, IPv4, are supported.

• SERVICE
  This parameter is used in the PXLOGICAL\PORT and PXPHYSICAL\PORT characteristics. A query of this parameter returns a semicolon-delimited string of services for only the first port. Supported services on the Windows Mobile Web browser (Internet Explorer Mobile) include CO-WSP and CO-SEC-WSP. Windows Mobile also supports accepting WAP push connectionless sessions over an Short Message Service (SMS) bearer for WAP push messages.

• STARTPAGE
  This parameter can be used in all PXLOGICAL characteristics. It identifies the start Web page for the proxy.

  Note

  If this parameter is present, an Internet Explorer Mobile browser favorite will be generated whose name corresponds to the PXLOGICAL NAME parameter value (or STARTPAGE value if NAME is not present), and whose URL corresponds to the STARTPAGE parameter value. If the URL's scheme is "http" or "https," it will be converted to "wsp" or "wsps," respectively.

• TO-NAPID
  This parameter is used in the PXPHYSICAL characteristic to identify the network access point associated with this physical proxy. Only one per proxy is supported.

  Note

  When adding a physical proxy, you must also add the NAP whose NAPID is referred to by TO-NAPID in the XML document.

• TRUST
  This parameter can be used in all PXLOGICAL characteristics to define whether or not the physical proxies in this logical proxy are privileged. The SECPOLICY_TRUSTED_WAP_PROXY security policy (4121) governs what roles can set this parameter.

  The following table shows the default settings.

  Access type	Read/write
  Roles allowed to query and update setting	Manager Operator Operator-TPS

Microsoft Custom Elements

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

The parameter-query and characteristic-query features are not supported for all PXPHYSICAL proxy parameters for all PXADDR types. All parameters can be queried when the PXPHYSICAL proxy PXADDRType is IPv4. For example, if a mobile operator queries the TO-NAPID parameter of a PXPHYSICAL proxy and the PXADDR Type is E164, a noparm is returned.

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

Tasks

PXLOGICAL Configuration Service Provider Examples for OMA Client Provisioning

Reference

WAP Logical Proxy: PXLOGICAL

Concepts

Configuration Service Provider Reference for Windows Mobile Devices
Bootstrapping To Use an OMA Client Provisioning Server