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.

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 IBM® MQ and XMSC_USERID is not set, then the queue manager uses 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 IBM MQ.

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 IBM MQ and XMSC_USERID is not set, then the queue manager uses 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 IBM MQ.

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