UltraLite Database User's Guide
Synchronization for UltraLite Applications
Stream parameters reference
The HTTPS synchronization stream is accessible from all UltraLite components.
To select HTTPS as the synchronization stream:
In UltraLite for MobileVB and UltraLite for eMbedded Visual Basic, choose ulHTTPS from the ULStreamType enumeration as the ULSyncParms.Stream.
For more information, see SyncParms.
In Native UltraLite for Java, supply StreamType.HTTPS 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 ULHTTPSStream() as the stream synchronization parameter.
For more information, see ULHTTPSStream function.
Separately-licensable option requiredUse of Certicom technology requires that you obtain the separately-licensable SQL Anywhere Studio security option and is subject to export regulations. For more information on this option, see "Welcome to SQL Anywhere Studio" in the book Introducing SQL Anywhere Studio. |
Synchronization stream parameters for the HTTPS 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. |
| 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. |
| certificate_company | The UltraLite application only accepts server certificates when the organization field on the certificate matches this value. By default, this field is not checked. |
| certificate_name | The UltraLite application only accepts server certificates when the common name field on the certificate matches this value. By default, this field is not checked. |
| certificate_unit | The UltraLite application only accepts server certificates when the organization unit field on the certificate matches this value. By default, this field is not checked. |
| 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. |
| 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. |