XATopicConnectionFactory

WebSphere MQ class: MQXATopicConnectionFactory

java.lang.Object
    |
    +----com.ibm.mq.jms.MQConnectionFactory
            |
            +----com.ibm.mq.jms.MQTopicConnectionFactory
                    |
                    +----com.ibm.mq.jms.MQXATopicConnectionFactory

An XATopicConnectionFactory provides the same create options as TopicConnectionFactory. Refer to Appendix E, JMS JTA/XA interface with WebSphere Application Server V4 for details about how WebSphere MQ JMS uses XA classes.

See also: TopicConnectionFactory and XAConnectionFactory

Methods

createXATopicConnection

public XATopicConnection createXATopicConnection()
                                     throws JMSException 

Create an XA topic connection using the default user identity. The connection is created in stopped mode. No messages are delivered until the Connection.start method is called explicitly.

Returns:

a newly created XA topic connection.

Throws:

• JMSException - if the JMS Provider fails to create an XA topic connection because of an internal error.
• JMSSecurityException - if client authentication fails because of a non valid user name or password.

createXATopicConnection

public XATopicConnection createXATopicConnection(java.lang.String userName,
                                                 java.lang.String password)
                                     throws JMSException 

Create an XA topic connection using the specified user identity. The connection is created in stopped mode. No messages are delivered until the Connection.start method is called explicitly.

Parameters:

• userName - the user name of the caller
• password - the password of the caller

Returns:

a newly created XA topic connection.

Throws:

• JMSException - if the JMS Provider fails to create an XA topic connection because of an internal error.
• JMSSecurityException - if client authentication fails because of a non valid user name or password.