UltraLite Database User's Guide
Synchronization for UltraLite Applications
Stream parameters reference
The ActiveSync synchronization stream is accessible only from Native UltraLite for Java, embedded SQL, and static C++ API applications running on Windows CE.
To choose ActiveSync synchronization:
In Native UltraLite for Java, supply StreamType.ACTIVE_SYNC as the argument to the syncParms.setStream method. For example:
_conn.syncParms.setStream( StreamType.ACTIVE_SYNC );
For more information, see ianywhere.native_ultralite.StreamType and ianywhere.native_ultralite.SyncParms in the Native UltraLite for Java API Reference.
In embedded SQL and the static C++ API, supply ULActiveSyncStream() as the stream synchronization parameter. For example:
ul_synch_info info; ... info.stream = ULActiveSyncStream();
For more information, see ULActiveSyncStream function.
The stream parameters control the connection from the MobiLink ActiveSync provider, running on the desktop machine, to the MobiLink synchronization server.
The stream parameters take the following form:
stream=stream_name;provider_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 provider_stream_parameters is a set of stream parameters for use by the ActiveSync provider, and has the same form as the stream parameters for the protocol in use. For the given stream, the provider_stream_parameters adopts the same defaults as the stream parameters for the protocol. The default value for the stream_name is tcpip.
For example, the following static C++ code uses an HTTP synchronization stream:
ULInitSynchInfo( &info ); info.stream = ULActiveSyncStream(); info.stream_parms = "stream=http"; ULSynchronize( &sqlca, &info );
For more information on provider_stream_parameters, see TCP/IP stream parameters, HTTP stream parameters, and HTTPS stream parameters.
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, a static C++ application may use a line such as the following:
info.stream_parms = "stream=tcpip;security=ecc_tls(trusted_certificates=trusted.crt)";
For more information, see CREATE SYNCHRONIZATION USER statement [MobiLink].