UltraLite Database User's Guide
Synchronization for UltraLite Applications
Stream parameters reference
The HTTP synchronization stream is accessible from all UltraLite components.
To select HTTP as the synchronization stream:
In UltraLite for MobileVB and UltraLite for ActiveX, choose ulHTTP from the ULStreamType enumeration as the ULSyncParms.Stream.
For more information, see SyncParms.
In Native UltraLite for Java, supply StreamType.HTTP as the argument for SyncParms.setStream().
For more information, see ianywhere.native_ultralite.StreamType and ianywhere.native_ultralite.SyncParms in the Native UltraLite for Java API Reference.
In embedded SQL or the static C++ API, supply ULHTTPStream() as the stream synchronization parameter.
For more information, see ULHTTPStream function.
Synchronization stream parameters for the HTTP stream are chosen from the following table:
| Parameter | Description |
|---|---|
| buffer_size=nnnn | The amount of memory allocated for sending content. The default is 1 K. |
|
client_port=nnnnn
client_port=nnnnn-mmmmm |
A range of client ports for communication. If only one value is specified, the end of the range is 100 greater than the initial value, for a total of 101 ports.
The option can be useful for clients inside a firewall communicating with a MobiLink synchronization server outside the firewall. |
| version= versionnumber | A string specifying the version of HTTP to use. You have a choice of 1.0 or 1.1. The default value is 1.1. |
| host=hostname |
The host name or IP number for the machine on which the MobiLink synchronization server is running. The default value is localhost.
For Windows CE, the default value is the value of ipaddr in the registry folder Comm\Tcpip\Hosts\ppp_peer. This allows a CE device to connect to a MobiLink synchronization server executing on the desktop machine where the CE device's cradle is connected. For the Palm Computing Platform, the default value of localhost refers to the device. It is recommended that an explicit host name or IP address be specified. |
| persistent={ 0 | 1 } | If this is set to 1 the client uses the same TCP connection for all HTTP requests in a synchronization. The default value is 1 on the Palm OS, and 0 elsewhere. |
| port=portnumber | The socket port number. The port number must be a decimal number that matches the port the MobiLink synchronization server is setup to monitor. The default value for the port parameter is 2439, which is the IANA registered port number for the MobiLink synchronization server. |
| proxy_host= proxy_hostname | The host name of the proxy server. |
| proxy_port= proxy_portnumber | The port number of the proxy server. The default value is 80. |
| url_suffix=suffix | The suffix to add to the URL on the first line of each HTTP request. When synchronizing through a proxy server, the suffix may be necessary in order to find the MobiLink synchronization server. The default value is MobiLink. |