Variables in parameters

The following macros provide access to information that may vary between remote devices. These values may be used in remote task conditions, in parameters for commands within remote tasks and in connection strings:

Variable Replacement

{ml_username}

The MobiLink user name (uid) being used by the Agent to synchronize with the agent database.

{ml_password}

The MobiLink password (pwd) being used by the Agent to synchronize with the agent database.

{ml_stream}

The protocol parameters for connecting to the MobiLink server. For example, HTTP{host=Sybase.com;port=9376}

{remote_id}

The remote ID for the remote database associated with this task. This value is only meaningful for in remote tasks that are marked as Requiring or Creating a Remote Database.

{agent_id}

The Agent ID.

{db_location}

The Agent's remote database directory, as specified by the mlagent -db option.

{battery_level}

The battery level for the remote device. The range is zero to one hundred (0-100).

{is_on_ac_power}

Indicates whether or not the remote device is using an AC power source. 1 indicates the device is plugged in and 0 indicates the device is running on battery power.

{rows_to_upload}

For UltraLite databases only. The number of rows in the remote database that will be uploaded if a full synchronization is done.

{agent_log}

The full path and file name for the Agent log file. This file can be uploaded from the device to help diagnose problems when necessary. If the Agent runs without a log file, this variable is an empty string.

{agent_db}

The full path and file name for the agent database file. This file can be uploaded from the device to help diagnose problems when necessary.