UltraLite User's Guide
  UltraLite Reference
    Synchronization parameters

security_parms synchronization parameter

Function 

Sets the parameters required when using transport-layer security. This parameter must be used together with the security parameter.

For more information, see security synchronization parameter.

C/C++ usage 

The ULSecureCerticomTLSStream() and ULSecureRSATLSStream() security parameters take a string composed of the following optional parameters, supplied in an semicolon-separated string.

• 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_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.

• 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.

For example, in embedded SQL:

ul_synch_info info;
...
info.stream = ULSocketStream();
info.security = ULSecureCerticomTLSStream();
info.security_parms =
     UL_TEXT( "certificate_company=Sybase" )
     UL_TEXT( ";" )
     UL_TEXT( "certificate_unit=Sales" );

The security_parms parameter is a string, and by default is null.

If you use secure synchronization, you must also use the -r command-line option on the UltraLite generator. For more information, see The UltraLite generator.

Java usage 

To use secure synchronization from UltraLite Java applications, choose a separate stream. For more information, see Initializing the synchronization options.