MobiLink Synchronization Reference
MobiLink Synchronization Client
Use the dbmlsync utility to synchronize Adaptive Server Anywhere remote databases with a consolidated database.
dbmlsync [ options ] [ transaction-logs-directory ]
| Option | Description |
|---|---|
| -a | Do not prompt for input again on error. See -a option |
| -ap | Specify authentication parameters. See -ap option. |
| -ba filename | Apply a download file. See -ba option. |
| -bc filename | Create a download file. See -bc option. |
| -be string | When creating a download file, add a string. See -be option. |
| -bg | When creating a download file, make it suitable for new remotes. See -bg option. |
| -c connection-string | Supply database connection parameters in the form parm1=value1; parm2=value2,... If you do not supply this option, a dialog will appear and you must supply connection information. See -c option. |
| -d | Drop any other connections to the database whose locks conflict with the articles to be synchronized. See -d option. |
| -dl | Display log messages on the console. See -dl option. |
| -ds | Specify download-only synchronization. See -ds option. |
| -e "option=value"... | Specify extended options. See -e extended options. |
| -eh | Ignore errors that occur in hook functions. |
| -ek key | Specify encryption key. See -ek option. |
| -ep | Prompt for encryption key. See -ep option. |
| -eu |
Specify extended options for upload defined by most recent -n option. See -eu option.
|
| -i filename | Execute file containing SQL statements immediately after synchronization. See -i option. |
| -is | Ignore schedule. See -is option. |
| -k | Close window on completion. See -k option. |
| -l | List available extended options. See -l option. |
| -mn password | Specify new MobiLink password. See -mn option. |
| -mp password | Specify MobiLink password. See -mp option. |
| -n name | Specify synchronization publication name(s). See -n option. |
| -o logfile | Log output messages to this file. See -o option. |
| -os size | Maximum size of output file. See -os option. |
| -ot logfile | Truncate file and log output messages to file. See -ot option. |
| -p | Disable logscan polling. See -p option. |
| -pd dllname;... | Preload specified dlls for Windows CE. See -pd option. |
| -pi | Test that you can connect to MobiLink. See -pi option. |
| -pp number | Set logscan polling period. See -pp option. |
| -q | Run in minimized window. See -q option. |
| -r[ a | b ] | Upload retry on client progress. See -r option. |
| -sc | Reload schema information before each synchronization. See -sc option. |
| -u ml_username | Allows you to specify the MobiLink user to synchronize. See -sc option. |
| -uo | Synchronization will be upload-only (no download). See -uo option. |
| -urc row-estimate | Allows you to specify an estimate of the rows that will be uploaded. See -urc option. |
| -v[ levels ] | Verbose operation. See -v option. |
| -wc classname | Specify a Windows class name for ActiveSync synchronization (Windows CE only). See -wc option. |
| -x | Rename and restart the transaction log. See -x option. |
| transaction-logs-directory | Specify the location of the transaction log. See Transaction Log File, below. |
Run dbmlsync on the command line to synchronize an Adaptive Server Anywhere remote database with a consolidated database.
To locate and connect to the MobiLink synchronization server, dbmlsync uses the information on the publication, synchronization user, synchronization subscription, or command line.
Transaction log file The transaction-logs-directory is the directory that contains the transaction log for the Adaptive Server Anywhere remote database. There is an active transaction log and transaction log archive files, both of which may be required by dbmlsync to determine what to upload. You must specify this parameter if the following are true:
the working log file has been truncated and renamed since you last synchronized
you run the dbmlsync utility from a directory other than the one where the renamed log files are stored
For more information, see Transaction log files.
Using a configuration file You can put dbmlsync command line options in a configuration file and optionally use the File Hiding utility, dbfhide, to add simple encryption to the configuration file. For more information, see Using configuration files and The File Hiding utility.
dbmlsync event hooks There are also dbmlsync client stored procedures that can help you customize the synchronization process. For more information, see Customizing the client synchronization process and Client event-hook procedures.
Using dbmlsync For more information about using dbmlsync, see Initiating synchronization.