public void setKeepPartialDownload(Boolean v)

UltraLite has the ability to restart downloads that fail because of communication errors. UltraLite processes the download as it is received. If a download is interrupted, then the partial download transaction remains in the database and can be resumed during the next synchronization.

To indicate that UltraLite should save partial downloads, specify Connection.syncParms.setKeepPartialDownload(true); otherwise, the download is rolled back when an error occurs.

If a partial download was kept, then the output field connection.SyncResult.getPartialDownloadRetained()} is set to true when the connection.synchronize() exits. If getPartialDownloadRetained() is set, then you can resume a download. To do this, call connection.synchronize() with connection.syncParms.setResumePartialDownload(boolean) set to true. If another communication error occurs, you might want keep KeepPartialDownload set to true. No upload is done if a download is skipped.

The download you receive during a resumed download is as old as when the download originally began. If you need the most up to date data, then you can do another download immediately after the special resumed download completes.

When resuming a download, many of the SyncParms fields are not relevant. For example, the PublicationMask field is not used. You receive the requested publications on the initial download. The only fields that need to be set are setResumePartialDownload(boolean) and setUserName(String). The field setKeepPartialDownload(boolean) may be set if desired and functions as normal.

If you have a partial download and it is no longer needed, then you can call Connection.rollbackPartialDownload() to roll back the failed download transaction. Also if you attempt to synchronize again and do not specify ResumePartialDownload, then the partial download rolls back before the next synchronization begins.

For more information, see How synchronization failure is handled.