tibemsSSLParams_SetRenegotiateSize


Function

SSL key renegotiation is deprecated in release 4.3; it is not supported in release 5.0.

Purpose

Set a size threshold for renegotiating the SSL shared encryption key.

C Declaration

tibems_status tibemsSSLParams_SetRenegotiateSize( 
    tibemsSSLParams SSLParams, 
    tibems_long bytes ); 

COBOL Call

CALL "tibemsSSLParams_SetRenegotiateSize" 
     USING BY VALUE SSLParams, 
           BY VALUE bytes, 
           RETURNING tibems-status 
END-CALL. 

SSLParams has usage pointer.

Parameter
Description
SSLParams
Set the value in this SSL parameter object.
bytes
Set the renegotiation size (in bytes) to this value.
The minimum value is 65536. If you supply a non-zero value that is less than this minimum, this minimum is used instead.
Zero is a special value, which disables renegotiation based on data size.

Remarks

The client program renegotiates the key it shares with the server after encrypting this number of bytes.

Renegotiating a key can adversely affect overall performance. If you set renegotiation parameters, ensure that renegotiation occurs only when truly required.


TIBCO Enterprise Message Service™ C and COBOL Reference
System Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com