UltraLite Static Java User's Guide
  Synchronization Parameters 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.

Access methods 

This parameter is not used in Java.

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

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:

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.