com.ibm.mq.jms
Class MQXAConnectionFactory

java.lang.Object
  |
  +--com.ibm.mq.jms.MQConnectionFactory
        |
        +--com.ibm.mq.jms.MQXAConnectionFactory
All Implemented Interfaces:
javax.jms.ConnectionFactory, javax.naming.Referenceable, java.io.Serializable, javax.jms.XAConnectionFactory

public class MQXAConnectionFactory
extends MQConnectionFactory
implements javax.jms.XAConnectionFactory

The MQXAConnectionFactory interface is an implementation of XAConnectionFactory interface.

WebSphere MQ JMS exposes its JTS support in the XAConnectionFactory, XAConnection, and XASession classes. These classes are provided for use in a J2EE application server environment.

WebSphere Application Server Version 5 uses these classes to create and manage a pool of XAConnection and XASession objects. A JMS application does not need to use these classes directly if it is running in this environment.

A JMS application might need to use the XAConnectionFactory class if it is running in a WebSphere Application Server environment with a version of WebSphere Application Server before Version 5.

See Also:
MQXAQueueConnectionFactory, MQXATopicConnectionFactory, Serialized Form

Field Summary
   
Constructor Summary
MQXAConnectionFactory()
          Default constructor.
 
Method Summary
 javax.jms.XAConnection createXAConnection()
          Creates an XA connection with the default user identity.
 javax.jms.XAConnection createXAConnection(java.lang.String userName, java.lang.String password)
          Creates an XA connection with the specified user identity.
 
Methods inherited from class com.ibm.mq.jms.MQConnectionFactory
createConnection, createConnection, getBrokerCCSubQueue, getBrokerControlQueue, getBrokerPubQueue, getBrokerQueueManager, getBrokerSubQueue, getBrokerVersion, getCCDTURL, getCCSID, getChannel, getCleanupInterval, getCleanupLevel, getClientId, getClientID, getCloneSupport, getConnTag, getDescription, getDirectAuth, getFailIfQuiesce, getHdrCompList, getHostName, getLocalAddress, getMapNameStyle, getMessageRetention, getMessageSelection, getMQConnectionOptions, getMsgBatchSize, getMsgCompList, getMulticast, getOptimisticPublication, getOutcomeNotification, getPollingInterval, getPort, getProcessDuration, getProxyHostName, getProxyPort, getPubAckInterval, getQueueManager, getReceiveExit, getReceiveExitInit, getReceiveIsolation, getRescanInterval, getSecurityExit, getSecurityExitInit, getSendExit, getSendExitInit, getSparseSubscriptions, getSSLCertStores, getSSLCertStoresAsString, getSSLCipherSuite, getSSLFipsRequired, getSSLPeerName, getSSLResetCount, getSSLSocketFactory, getStatusRefreshInterval, getSubscriptionStore, getSyncpointAllGets, getTargetClientMatching, getTemporaryModel, getTempQPrefix, getTransportType, getUseConnectionPooling, getVersion, setBrokerCCSubQueue, setBrokerControlQueue, setBrokerPubQueue, setBrokerQueueManager, setBrokerSubQueue, setBrokerVersion, setCCDTURL, setCCSID, setChannel, setCleanupInterval, setCleanupLevel, setClientId, setClientID, setCloneSupport, setConnTag, setDescription, setDirectAuth, setFailIfQuiesce, setHdrCompList, setHostName, setLocalAddress, setMapNameStyle, setMessageRetention, setMessageSelection, setMQConnectionOptions, setMsgBatchSize, setMsgCompList, setMulticast, setOptimisticPublication, setOutcomeNotification, setPollingInterval, setPort, setProcessDuration, setProxyHostName, setProxyPort, setPubAckInterval, setQueueManager, setReceiveExit, setReceiveExitInit, setReceiveIsolation, setRescanInterval, setSecurityExit, setSecurityExitInit, setSendExit, setSendExitInit, setSparseSubscriptions, setSSLCertStores, setSSLCertStores, setSSLCipherSuite, setSSLFipsRequired, setSSLPeerName, setSSLResetCount, setSSLSocketFactory, setStatusRefreshInterval, setSubscriptionStore, setSyncpointAllGets, setTargetClientMatching, setTemporaryModel, setTempQPrefix, setUseConnectionPooling
 
Methods inherited from class java.lang.Object
getClass, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

MQXAConnectionFactory

public MQXAConnectionFactory()
Default constructor.

Method Detail

createXAConnection

public javax.jms.XAConnection createXAConnection(java.lang.String userName,
                                                 java.lang.String password)
                                          throws javax.jms.JMSException
Creates an XA connection with the specified user identity. The connection is created in stopped mode. No messages are delivered until the XAConnection.start() method is called explicitly.

Specified by:
createXAConnection in interface javax.jms.XAConnectionFactory
Parameters:
userName - the user name of the caller.
password - the password of the caller.
Returns:
a newly created XA connection.
Throws:
javax.jms.JMSException - if JMS fails to create an XA connection because of an internal JMS error.
javax.jms.JMSSecurityException - if client authentication fails because the user name or password is not valid.
Since:
JMS 1.1

createXAConnection

public javax.jms.XAConnection createXAConnection()
                                          throws javax.jms.JMSException
Creates an XA connection with the default user identity. The connection is created in stopped mode. No messages are delivered until the XAConnection.start method is called explicitly.

Specified by:
createXAConnection in interface javax.jms.XAConnectionFactory
Returns:
a newly created XA connection.
Throws:
javax.jms.JMSException - if JMS Provider fails to create XAConnection due to some internal error.
javax.jms.JMSSecurityException - if client authentication fails due to invalid user name or password.
Since:
JMS 1.1

(c) Copyright IBM Corp. 2005. All Rights Reserved.