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

{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.

{agent_id}

The Agent ID.

{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.

{battery_level}

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

{db_location}

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

{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.

{is_online}

This variable evaluates to 1 (true) if and only if the client device is connected to a network such that there is a route to the IP address of the MobiLink server. The host computer may be offline and the variable will still evaluate to 1 (true).

{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}

{ml_username}

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

{network_conn_name}

Evaluates to the name of the network connection that is used by the Agent for communication with the MobiLink server. If there is no network connection that can be used by the Agent to communicate with the MobiLink server, this variable evaluates to ?.

{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.

{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.