WebSphere WebSphere Business Integration Message Service Clients for C/C++ Version 1.2.7 and .NET Version 1.2.6 Operating Systems: AIX, Linux, Solaris, Windows

IConnectionFactory

An application uses a connection factory to create a connection.

Inheritance hierarchy:
IBM.XMS.IPropertyContext
   |
   +----IBM.XMS.IConnectionFactory

For a list of the XMS defined properties of a ConnectionFactory object, see Properties of ConnectionFactory.

Related concepts
ConnectionFactories and Connection objects
Connection to a WebSphere service integration bus
Secure connections to a WebSphere MQ queue manager
Secure connections to a WebSphere service integration bus messaging engine
Property mapping for administered objects
Related tasks
Creating administered objects
Related reference
Required properties for administered ConnectionFactory objects

Methods

Summary of methods:
Method Description
CreateConnection Create a connection factory with the default properties.
CreateConnection Create a connection using a specified user identity.

CreateConnection – Create Connection Factory (using the default user identity)

Interface:
IConnection CreateConnection();

Create a connection factory with the default properties.

If you are connecting to WebSphere MQ, and you set the XMSC_USERID property of the connection factory, it must match the userid of the logged on user. If you do not set these properties, the queue manager will use the userid of the logged on user by default. If you require further connection-level authentication of individual users you can write a client authentication exit which is configured in WebSphere MQ. You can learn more about creating a client authentication exit in the Authentication topic in the WebSphere MQ Clients manual.

Parameters:
None
Exceptions:
  • XMSException

CreateConnection – Create Connection (using a specified user identity)

Interface:
IConnection CreateConnection(String userId, String password);

Create a connection using a specified user identity.

If you are connecting to WebSphere MQ, and you set the XMSC_USERID property of the connection factory, it must match the userid of the logged on user. If you do not set these properties, the queue manager will use the userid of the logged on user by default. If you require further connection-level authentication of individual users you can write a client authentication exit which is configured in WebSphere MQ. You can learn more about creating a client authentication exit in the Authentication topic in the WebSphere MQ Clients manual.

The connection is created in stopped mode. No messages are delivered until the application calls Connection.start().

Parameters:
userID (input)
A String object encapsulating the user identifier to be used to authenticate the application. If you provide a null, an attempt is made to create the connection without authentication.
password (input)
A String object encapsulating the password to be used to authenticate the application. If you provide a null, an attempt is made to create the connection without authentication.
Returns:
The Connection object.
Exceptions:
  • XMSException
  • XMS_X_SECURITY_EXCEPTION

Inherited properties and methods


Reference topic

Terms of Use | Rate this page

Last updated: 18 Jun 2008

© Copyright IBM Corporation 2005, 2008. All Rights Reserved.