Contents Index Utilities MobiLink stop utility

MobiLink Synchronization Reference
  Utilities

ActiveSync provider installation utility


Installs a MobiLink provider for ActiveSync, or registers and installs UltraLite applications on Windows CE devices.

Syntax 

dbasinst [options ] [ [ src ] dst name class [ args ] ]

Options Description
-d Disable the application on creation.
-k path Specify the location of the desktop provider dbasdesk.dll.
-n Register the application but do not copy it to the device.
-u Uninstall the MobiLink ActiveSync provider.
-v path Specify the location of the device provider dbasdev.dll.
Args Description
src The source filename and path for an application.
dst The destination filename and path for an application.
name The name of the application.
class The registered Windows class name of the application.
args Command line arguments to use when ActiveSync starts the application.
Description 

This utility installs a MobiLink provider for ActiveSync. The provider includes both a component that runs on the desktop (dbasdesk.dll) and a component that is deployed to the Windows CE device (dbasdev.dll). The dbasinst utility makes a registry entry pointing to the current location of the desktop provider; and copies the device provider to the device.

If additional arguments are supplied, the dbasinst utility can also be used to register and install UltraLite applications onto a Windows CE device. Alternatively, you can register and install UltraLite applications using the ActiveSync software.

Subject to licensing requirements, you may supply this application, together with the desktop and device components to end users, so that they can prepare their copies of your application for use with ActiveSync.

You must be connected to a remote device to install the ActiveSync provider.

For complete instructions on using the ActiveSync provider installation utility, see Installing the MobiLink provider for ActiveSync, and Registering applications for use with ActiveSync.

Options 

-d    By default, an application registered by dbasinst is enabled, meaning that it is automatically synchronized when ActiveSync begins a synchronization. With the -d option, the application is still registered, but it is unchecked in the ActiveSync MobiLink settings dialog.

-k    The path to the desktop provider dbasdesk.dll. By default the file is looked for in the or win64 subdirectory of your SQL Anywhere directory. End users (who generally do not have the full SQL Anywhere install) may need to specify -k when installing the MobiLink ActiveSync provider.

-n    In addition to installing the MobiLink ActiveSync provider, register an application but do not copy it to the device. This is appropriate if the application includes more than one file (for example, if it is compiled to use the UltraLite runtime library DLL rather than a static library) or if you have an alternative method of copying the application to the device.

-u    Unregister all applications that have been registered for use with the MobiLink ActiveSync provider and uninstall the MobiLink ActiveSync provider. No files are deleted from the desktop machine or the device by this operation. If the device is not connected to the desktop, an error is reported.

-v    The path to the device provider dbasdev.dll. By default the file is looked for in a platform-specific directory under the CE subdirectory of your SQL Anywhere directory. End users (who generally do not have the full SQL Anywhere install) may need to specify -v when installing the MobiLink ActiveSync provider.

Arguments 

src    The source filename and path for copying an application to the device. Supply this parameter only if you are registering an application and copying it to the device: do not supply the parameter if you use the -n option.

dst    The destination filename and path on the device for an application.

name    The application name. This is the name by which ActiveSync refers to the application.

class    The registered Windows class name for the application.

args    Any command line arguments to be used when ActiveSync starts the application.

Examples 

The following command installs the MobiLink provider for ActiveSync using default arguments. It does not register an application. The device must be connected to your desktop for the installation to succeed.

dbasinst

The following command uninstalls the MobiLink provider for ActiveSync. The device must be connected to your desktop for the uninstall to succeed:

dbasinst -u

The following command installs the MobiLink provider for ActiveSync, if it is not already installed, and registers the application myapp.exe. It also copies the c:\My Files\myapp.exe file to \Program Files\myapp.exe on the device. The -p -x arguments are command line options for myapp.exe when started by ActiveSync. The command must be entered on a single line:

dbasinst "C:\My Files\myapp.exe" "\Program Files\myapp.exe"
   "My Application" MYAPP -p -x
See also 

Using ActiveSync synchronization

Installing the MobiLink provider for ActiveSync

Registering applications for use with ActiveSync

Synchronization for UltraLite Applications

ActiveSync synchronization stream parameters


Contents Index Utilities MobiLink stop utility