Listener options for device tracking

The following dblsn options are used for device tracking.

Use -x, -u, and -w to specify how to connect to the MobiLink server. This is required if you are using device tracking so that the remote device can update the consolidated database if the address changes. These are also required if you want to send delivery confirmations to the consolidated database.

The -t+ option is recommended. With it, you can register the MobiLink user name of your remote database and use it when you address notifications instead of addressing the MobiLink user name of the Listener database. You only need to do this once.

  • -t+ ml_user   Use this option to register the MobiLink user name of your remote database so that you can use that user name as the address in your push requests.

    You can register multiple MobiLink user names with -t+. This is useful if you need to address notifications to different applications on the remote device, such as multiple remote databases.

    This mapping is retained on the server (in the ml_listening table) once tracking information is uploaded successfully, so you only need to register a MobiLink user name once unless you change the MobiLink user name or location. However, using -t+ multiple times is not harmful.

  • -t- ml_user   To disable a MobiLink user name that was registered for device tracking with -t+, use -t-.

  • -u ML_user_name   Use -u to create a MobiLink user name for the Listener. The -u option is optional because there is a default Listener_name, which is device_name-dblsn, where device_name is the name of your device. You can find the device name in your Listener messages window. Optionally, you can set the device name using the -e option.

    Whether or not you use the default name, you may need to add the Listener_name to the ml_user MobiLink system table on your consolidated database. This is because the Listener_name is a MobiLink user name. Like other MobiLink user names, it must be unique and it must be in the ml_user MobiLink system table on your consolidated database.

    See Creating and registering MobiLink users.

  • -w password   This option sets the password for the Listener name.

  • -x connection-parameters    Use -x to specify how to connect to the MobiLink server. This is required if you are using device tracking because it lets the remote device update the consolidated database if the address changes. This option is also required if you want to send delivery confirmations to the consolidated database.

  • -y   This option updates the password for the Listener name.

For more information about Listener options, see Listener syntax.

Example

The following command starts the Listener with device tracking.

dblsn -l "subject=sync;action='run dbmlsync.exe -c dsn=rem1'"
 -x tcpip(host=MLSERVER_MACHINE) -t+ user1 -u remoteuser1

Stopping device tracking