UltraLite Database User's Guide
   Synchronization for UltraLite Applications
    Stream parameters reference

HotSync synchronization stream parameters

The HotSync synchronization stream is accessible only from UltraLite for MobileVB applications, embedded SQL applications, and static C++ API applications running on the Palm Computing Platform. Unlike HTTP or TCP/IP synchronization, HotSync synchronization is initiated externally by the HotSync Manager, rather than by a synchronization function within the UltraLite applcation.

To choose HotSync synchronization:

• In UltraLite for MobileVB, choose ulPalmConduit from the ULStreamType enumeration as the ULSyncParms.Stream.

  For more information, see SyncParms.

• In embedded SQL or the static C++ API, supply the ul_synch_info structure to the ULPalmExit or ULData::PalmExit method of your application. The stream parameter is ignored and may be set to UL_NULL.

  For more information, see ULPalmExit function.

Meaning of synchronization stream parameters 

For HotSync synchronization, the stream parameters do not control the connection from the device to the HotSync Manager or HotSync Server. Instead, they specify the connection from the MobiLink conduit, running at the HotSync manager or server, to the MobiLink synchronization server.

The argument has the following form:

stream=stream_name;conduit_stream_parameters

where stream_name indicates the protocol for the conduit to use when communicating from the conduit to the MobiLink synchronization server. It must be one of the following:

• tcpip

• http

• https

and where conduit_stream_parameters is a set of stream parameters for use by the conduit, and has the same form as the stream_parms argument for the protocol in use. For the given stream, the conduit_stream_parameters adopts the same defaults as the stream_parms argument for the protocol. The default value for the stream_name is tcpip.

For example, the following embedded SQL code uses an HTTP synchronization stream:

ULInitSynchInfo( &info );
info.stream_parms = "stream=http";

For more information on conduit_stream_parameters, see TCP/IP stream parameters, HTTP stream parameters, and HTTPS stream parameters.

Null value and default settings 

If you use HotSync synchronization, and do not supply stream parameters, the conduit searches in the registry for the stream name and stream parameters. If it finds no valid stream, the default stream and stream parameters is used. This default stream parameter setting is:

stream=tcpip;host=localhost

Adding encryption to HotSync synchronization 

To add Certicom encryption to the stream, the root certificates must be in a file on the desktop machine. This is different from other UltraLite applications, where the encryption information is embedded in the security synchronization parameter.

The stream parameters need to be specified in the stream parameters in much the same way as for Adaptive Server Anywhere MobiLink clients . The format is:

security=cipher{ keyword=value;... }

where cipher must be certicom_tls and the keywords are taken from the following list:

• certificate_company    The organization field on the certificate.

• certificate_unit    The organization unit field on the certificate.

• certificate_name    The common name field on the certificate.

• trusted_certificates    The location of the trusted certificates.

For example, in a static C++ application:

info.stream_parms = "stream=tcpip;security=ecc_tls(trusted_certificates=trusted.crt)";

For more information, see CREATE SYNCHRONIZATION USER statement [MobiLink].