Using Macros in SOTI MobiControl

Use macros to automatically pull information from your devices and input it as a value into SOTI MobiControl.

For example, during enrollment, instruct SOTI MobiControl to name your devices according to device specific data, such as the IMEI numbers or MAC addresses.

Use macros in various places throughout the SOTI MobiControl console, such as device naming during enrollment, within specific profile configurations, and other device configurations or tracking actions.

Note: Macros resolve whenever a device checks in to update SOTI MobiControl. Device names can change to reflect this new information.

Available Macros

SOTI MobiControl supports several macros. However, not every macro is available for every situation or for every device type. Supported macros for a particular situation display in the macros drop-down list beside the relevant field.

Tip: When naming devices, you can link many macros together to create unique names.
Description Macro
Auto Incrementing Numbered Sequence

The default %AUTONUM% macro begins numbering at 00001

The customizable %AUTONUM:X%, where X = a number ranging from 0 to 9, lets you specify a minimum number of padding of leading zeroes. %AUTONUM:3% would begin numbering with 0001.

Both %AUTONUM% macros increase in increments of 1.

 %AUTONUM%

%AUTONUM:X%
Date and time of the device %DEVICE_DATE_TIME%
Device ID
  • %DeviceID% for Android Plus devices
  • %DeviceIdentifier% for iOS devices
Device MAC Address %MAC%
Device Manufacturer %MANUFACTURER%
Device Model %MODEL%
Device Name %MCDEVICENAME%
Device Platform %PLATFORM%
Device Serial Number %SERIALNUM%
Enrolled User Domain %ENROLLEDUSER_DOMAIN%
Enrolled User Email %ENROLLEDUSER_EMAIL%
Enrolled User Principal Name %ENROLLEDUSER_UPN%
Enrolled User Username %ENROLLEDUSER_USERNAME%
ESN (Electronic Serial Number) for Samsung devices %ESN%
ICCID (Integrated Circuit Card Identifier) %ICCID%
IMEI (International Mobile Equipment Identity) %IMEI%
IMSI (International Mobile Subscriber Identity) %IMSI%
IP address of the device %IP%
Lockscreen Message

If a lockscreen message is not configured on the device, SOTI MobiControl uses %PLATFORM% %AUTONUM% to name the device.

 %LOCKSCREEN_MESSAGE
Operating System Version %OS%
Personalized Device Name %PERSONALIZED_DEVICE_NAME%
Phone Number %PHONENUMBER%
SD Card

Points to the primary shared/external storage directory.

Note: This directory might not be accessible on Android 11 and later due to the scoped storage enforcement.
 %SDCARD%
The IP address from which the device is connecting to the DS. This may or may not be the local IP address of the device, depending on the connection topology. %HOSTNAME%