SyncParadata Function

Format

b = syncparadata(direction);

Description

The syncparadata function transfers paradata between a device and a synchronization server. Before calling syncparadata, you must first connect to the server by calling syncconnect.

The function can upload paradata from the local device (client) to the server as well as download paradata from the server. The direction argument determines which of these operations is performed. It must be one of the following values:

GET: Download any paradata that was sent to the server since the last sync and add it to the currently open paradata log.
PUT: Upload to the server any paradata that was collected since the last sync.
BOTH: Sync paradata in the currently open paradata log with the server in both directions (i.e., perform both a GET and a PUT).

The syncparadata function keeps track of what paradata has been transferred each time the client and server are synchronized and uses this information to only transfer paradata that has been collected since the last synchronization. This significantly reduces the amount of data transferred and therefore reduces bandwidth and the cost of air time.

Paradata logs can be very large so be careful about adding paradata synchronizations to your applications. If you are interested in syncing paradata, a general suggestion is to use BOTH when syncing between devices using Bluetooth, and to use PUT to a CSWeb, Dropbox, or FTP server.

Return Value

The function returns a logical value of 1 (true) if the transfer was successful and 0 (false) otherwise.

Example

if syncconnect(Bluetooth) then

// other sync actions...

syncparadata(BOTH);

syncdisconnect();

endif;