Mobile Application Link Source Distribution
-------------------------------------------
Version 0.3                January 13, 1999

ActiveSync Desktop DLL
----------------------
This project contains the desktop side of the Windows CE ActiveSync Module.
The device side of the ActiveSync Module is located in
mal/client/wince/activesync/client.

The MAL Windows CE ActiveSync Module supports device side plugins to allow
each database that is synchronized through MAL to be stored differently.
A sample device side plugin is located in mal/test/activesynctest.


Building
--------
Microsoft Visual C++ 6.0 with the appropriate Windows CE Platform SDK is
required for building the ActiveSync DLLs.  By default, the ActiveSync
Desktop DLL (AGSyncCEDesktop.dll) will be installed in D:\mal.


Configuration
-------------
To configure the MAL ActiveSync Desktop DLL, load the registry setting
contained in the file mal/client/wince/activesync/desktop/AGSyncCEDesktopKeys.reg
into the registry on the desktop.  Restart Windows to ensure that these
registry settings are properly loaded.


Synchronization
---------------
After building and configuring both the device side of the ActiveSync Module and
the device side plugin dll, the device can be synchronized to a MAL server through
a cradle.  On the initial synchronization, a dialog will appear allowing you to 
specify the name and port of the MAL server you wish to connect to as well as the
user name and password used to connect.  This dialog can appear on both the desktop
and the device, however any settings entered on the device are currently ignored.
The settings that are entered into this dialog are saved in the file
D:\AvantGo\agconfig.csc.  If you need to reenter the data on this dialog, simply
delete this file to cause the dialog to reappear the next time you synchronize.

Currently, the device will only successfully synchronize the first time after it is
inserted into the cradle.  Subsequent synchronizations will fail with the message
"CeRapiInvoke failed." followed by the message "The Files syncronization service
failed.  Please contact the service's manufacturer for assistance in correcting
the problem."  The device must be removed from the cradle and reinserted to
reenable synchronization.


To Do
-----
- Server config settings should be dynamically obtained from device during
  synchronization.
- Does not currently use proxy settings to communicate with MAL server.

Last Updated: January 13, 1999
Owner: Jason Beaver (jason@avantgo.com)
