+

Search Tips | Advanced Search

IConnectionFactory

An application uses a connection factory to create a connection.

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 WebSphere 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 we can write a client authentication exit which is configured in WebSphere 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 WebSphere 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 we can write a client authentication exit which is configured in WebSphere 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

The following methods are inherited from the IPropertyContext interface: