Device Naming Macros

The following macros can be used for naming devices.

%AUTONUM% Allows you to automatically use a numbered sequence as part of the device name. For example, if the value of this field is set to WH%AUTONUM%, then the first device configured will be assigned a name of WH00001, the second device will have a name of WH00002, and so on.
%MAC% Expands to the MAC address of the device. This macro is suitable for use with devices that have a wireless or wired networking capability. The MAC address is a unique number that is built into the network hardware used on the device. In most cases SOTI MobiControl can retrieve the MAC address from the hardware. For example, if the value of this field is set to DEV%MAC%, then the device names configured would look similar to DEV00A0F85324D4 and DEV00A0F8533422. When the %MAC% macro is used as the device ID, the wifi radio must be enabled when the agent is installed in order for the macro to work.
%HOSTNAME% Expands to the IP address of the device on its local network. We recommend using this macro only in cases where unique hostnames have previously been assigned to devices before the device agent is installed.
%IP% Expands to the IP address of the device. We recommend using this macro only in cases where the devices have wireless or wired networking capabilities and are using fixed IP addresses. The use of this macro is not suitable for situations in which the devices are using dynamic IP addresses (i.e. DHCP) since when the IP address changes the device name will be incorrect.
%PHONENUMBER% Expands to the phone number of the device. We recommend using this macro only in cases where the device is a Smartphone or Pocket PC Phone Edition. For some devices, the phone number may not be available.
%IMEI% Expands to the IMEI (International Mobile Equipment Identity) number of the device. We recommend using this macro only in cases where the device is a Smartphone or Pocket PC Phone Edition. For some devices the IMEI number may not available.
%ESN% Expands to the ESN (Electronic Serial Number) of the device. We recommend using this macro only in cases where the device is a Smartphone or Pocket PC Phone Edition. For some devices the ESN number may not available.
%IMSI% Expands to the IMSI (International Mobile Subscriber Identity) number of the device. We recommend using this macro only in cases where the device is a Smartphone or Pocket PC Phone Edition. For some devices the IMSI number may not available.
%REG://% Expands to the registry in the device. This will allow custom names like serial number (read from registry key) to be used out of the box for device naming. For example, %REG://HKEY_LOCAL_MACHINE\Software\Apps\SOTI\MobiControl?VN=ESN%
%TXT://% Gets the content of a specified line of the text file. (If LN is not specified, it assumes the first line.) For example, %TXT://\Device.log?LN=1%
%INI://% Pulls a value from a section in a .ini file and makes it the device name. For example, %INI://\pdb.ini?SC=Device&NM=DeviceName%
%EXE://% Gets the exit code of the executable and makes it the device name. For example, %EXE://\windows\system32\calc.exe%
%STDOUT% Pulls the first line of STDOUT output of the executable and makes it the device name. For example, %STDOUT://cmd.exe /c dir%