DownloadBufferSize (dbs) extended option

Specifies the size of the download buffer.

Syntax
dbs=number[ K | M ]; ...
Remarks

The buffer size is specified in units of bytes. Use the suffix k or m to specify units of kilobytes or megabytes, respectively.

If you set this option to 0, dbmlsync does not buffer the download. If this option is greater than 0, the entire download stream is read from the communication stream with the MobiLink server before it is applied to the remote database. If the download stream fits in the space specified by the option then it is held entirely in memory; otherwise some of it is written to a temporary file.

If the setting is greater than 0 but less than 4 KB, dbmlsync uses a 4 KB buffer size and issues a warning. The default is 32k on Windows Mobile, and 1m on all other operating systems.

This option has a short form and long form: you can use dbs or DownloadBufferSize.

You can also store extended options in the database. For more information about dbmlsync extended options, see Introduction to dbmlsync extended options.

Example

The following dbmlsync command line illustrates how you can set this option when you start dbmlsync:

dbmlsync -e "dbs=32k"

The following SQL statement illustrates how you can store this option in the database:

CREATE SYNCHRONIZATION SUBSCRIPTION
   TO sales_publication
   FOR ml_user1
   OPTION dbs='32k';