tibemsConnectionFactory_CreateConnection


Function

Purpose

Create a connection object.

C Declaration

tibems_status tibemsConnectionFactory_CreateConnection( 
    tibemsConnectionFactory factory, 
    tibemsConnection* connection, 
    const char * username, 
    const char * password ); 

COBOL Call

CALL "tibemsConnectionFactory_CreateConnection" 
     USING BY VALUE factory, 
           BY REFERENCE connection, 
           BY REFERENCE username, 
           BY REFERENCE password, 
           RETURNING tibems-status 
END-CALL.
factory and connection 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.

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

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