Copyright © TIBCO Software Inc. All Rights Reserved

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

> Parameters

> Parameter | Description
> factory | Use this connection factory to create a connection.
> connection | The function stores the new connection object in this location.
> userName | The connection object presents this user identity to the server. Set to NULL if the server isn’t authenticating or authorizing users.
> password | The connection object authenticates the user identity with this password. Set to NULL if the server isn’t authenticating or authorizing users.

> 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 on page 202

Copyright © TIBCO Software Inc. All Rights Reserved