Websites Navigation: Airbit | Shop | m-shell.net
Languages: EN | DE

Supervisor Properties File

The behaviour of the m Supervisor is configured in the supervisor properties. Selecting View→Supervisor opens a dialog to edit them.

The properties are stored in an 8-bit text file with the same format as the m property file described in the previous section. The file resides in "c:\iwlib\mSupervisor.prp" or "c:\shared\iwlib\mSupervisor.prp" (on UIQ3 devices).

The following keys are recognized by the supervisor:

  • enabled=true|yes|y|1 | false|no|n|0
    If set to true, yes, y or 1, the supervisor background process will be created and persistent as long as the device is on.
  • onboot=true|yes|y|1 | false|no|n|0 | once | restart
    If set to true, yes, y or 1, the m application will be started automatically when the phone is booted up, i.e. switched on.
    If set to once, m is only started at the next bootup, as the entry is automatically set to n afterwards. This is the recommended setting for disaster prevention during script testing.
    If set to restart, m is started automatically when the phone is booted up, and restarted each time about 20 seconds after it exits (orderly or because of a crash).
  • smsctrl=true|yes|y|1 | false|no|n|0
    If set to true, yes, y or 1, the m application can be controlled via SMS commands, even if it is not running. See chapter * ().
  • smskey=keyword
    Any SMS containing keyword as the first characters (ignoring case) is considered a command and sent to the m application.
  • smsnr=suffix
    The last digits of the sender phone number which can control the m application via SMS. If empty, anybody knowing smskey can control m.
A sample supervisor properties file might look as follows:

enabled=yes
onboot=once
smsctrl=yes
smsnr=4561234
smskey=mshell


© 2004-2011 airbit AG, CH-8008 Zürich
Document AB-M-SUP-887
mShell Home  > Documentation  > Manuals