tibemsConnectionFactory_CreateConnectionSSL


Function

Purpose

Create an SSL connection object.

C Declaration

tibems_status tibemsConnectionFactory_CreateConnectionSSL( 
    tibemsConnectionFactory factory, 
    tibemsConnection* connection, 
    const char * username, 
    const char * password, 
    tibemsSSLParams SSLparams, 
    const char * pk_password ); 

COBOL Call

CALL "tibemsConnectionFactory_CreateConnectionSSL" 
     USING BY VALUE factory, 
           BY REFERENCE connection, 
           BY REFERENCE username, 
           BY REFERENCE password, 
           BY VALUE SSLparams, 
           BY REFERENCE pk-password, 
           RETURNING tibems-status 
END-CALL. 

factory, connection, and SSLparams have usage pointer.

Parameter
Description
factory
Use this connection factory to create a connection.
connection
The function stores the new connection object in this location.
userName
When non-null, the connection object presents this user identity to the server.
password
When non-null, the connection object authenticates the user identity with this password.
SSLParams
When non-null, the connection establishes SSL communication using these parameters, overriding the connection factory’s default SSL parameters.
Null is a special value, which instructs the call to use the connection factory’s default SSL parameters.
pk_password
Private key password for SSL.

Remarks

When the identity parameters are null, the connection object presents a default user identity. If the server configuration permits that anonymous user, then the call succeeds.

See Also

tibemsSSLParams

tibemsConnection


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