Hosts Manager

EMDK For Xamarin - 2.5

Overview

The HostsMgr allows the device to be assigned a Host Name by which the device can be identified by admins, applications and other devices on local and DNS-enabled IP networks. The Host Name binds the device's friendly name (i.e. “MyDevice”) to its IP address so that its friendly name can be used interchangeably with its "unfriendly" IP address. A friendly name can be registered with a DNS Server (if one is present on a given network) when the device joins that network, thereby allowing other stations on the network to more easily identify other devices present on the network.

Main Functionality

  • Can Set and display the device Host Name as a string between 0 and 255 characters

Set Host Name

This parm permits a Host Name to be assigned to a device, binding that name to the device IP address. The device can then be identified using its friendly name (i.e. “MyDevice”) by admins, applications and other devices on local and DNS-enabled IP networks. Once bound, the Host Name and IP address can be used interchangeably. A friendly name also can be registered with a DNS Server (if one is present on a given network) when the device joins that network, thereby allowing other stations on the network to more easily identify other devices present on the network.

Parm value rules

  • Accepts a string in field HostName
  • Minimum size is 0 characters (no name assigned); maximum size is 255 characters
  • Does not accept the ampersand (&) character; other special characters are allowed

Parm Name: HostName

Requires:

  • MX: 5.1+

Examples

Set Host Name

Input


<wap-provisioningdoc>
    <characteristic type="HostsMgr">
        <parm name="HostName" value="MyDevice"/>
    </characteristic>
</wap-provisioningdoc>

Output


<wap-provisioningdoc>
    <characteristic type="HostsMgr" version="5.1">
       <parm name="HostName" value="MyDevice"/>
    </characteristic>
    </wap-provisioningdoc>


Get Current Host Name (and CSP version)

Input

<wap-provisioningdoc>
    <characteristic type="HostsMgr">
        <parm-query name="Version"/>
        <parm-query name="HostName"/>
    </characteristic>
</wap-provisioningdoc>

Output

<wap-provisioningdoc>
    <characteristic type="HostsMgr" version="5.1">
        <parm name="Version" value="5.1.1"/>
        <parm name="HostName" value="MyDevice"/>
        </characteristic>
    </wap-provisioningdoc>