com.ibm.mq.jms

Class MQXAConnectionFactory

java.lang.Object

com.ibm.msg.client.jms.internal.JmsReadablePropertyContextImpl

com.ibm.msg.client.jms.internal.JmsPropertyContextImpl

com.ibm.msg.client.jms.admin.JmsConnectionFactoryImpl

com.ibm.msg.client.jms.admin.JmsJndiConnectionFactoryImpl

com.ibm.mq.jms.MQConnectionFactory

com.ibm.mq.jms.MQXAConnectionFactory

All Implemented Interfaces:

JmsConnectionFactory, JmsPropertyContext, JmsReadablePropertyContext, JmsXAConnectionFactory, com.ibm.msg.client.provider.ProviderPropertyContextCallback, java.io.Serializable, java.util.Map<java.lang.String,java.lang.Object>, javax.jms.ConnectionFactory, javax.jms.XAConnectionFactory, javax.naming.Referenceable

public class MQXAConnectionFactory
extends MQConnectionFactory
implements JmsXAConnectionFactory, javax.jms.XAConnectionFactory

The MQXAConnectionFactory interface is an implementation of the XAConnectionFactory interface.

WebSphere MQ JMS exposes its JTS support in the MQXAConnectionFactory, MQXAConnection, and MQXASession classes. These classes are provided for use in a J2EE application server environment.

See Also:

MQXAQueueConnectionFactory, MQXATopicConnectionFactory, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.ibm.mq.jms.MQConnectionFactory

MQConnectionFactory.ConnectionFactoryProperty

Nested classes/interfaces inherited from interface java.util.Map

java.util.Map.Entry<K,V>

Constructor Summary

Constructors

Constructor and Description
MQXAConnectionFactory() Default constructor.

Method Summary

Methods

Modifier and Type	Method and Description
javax.jms.XAConnection	createXAConnection() Creates an XA connection with the default user identity.
javax.jms.XAConnection	createXAConnection(java.lang.String userid, java.lang.String password) Creates an XA connection with the specified user identity.
javax.jms.XAJMSContext	createXAContext()
javax.jms.XAJMSContext	createXAContext(java.lang.String userName, java.lang.String password)

Methods inherited from class com.ibm.mq.jms.MQConnectionFactory

createConnection, createConnection, getAppName, getAsyncExceptions, getBrokerCCSubQueue, getBrokerControlQueue, getBrokerPubQueue, getBrokerQueueManager, getBrokerSubQueue, getBrokerVersion, getCCDTURL, getCCSID, getChannel, getCleanupInterval, getCleanupLevel, getClientId, getClientID, getClientReconnectOptions, getClientReconnectTimeout, getConnectionNameList, getConnTag, getDescription, getDirectAuth, getFailIfQuiesce, getHdrCompList, getHostName, getLocalAddress, getMapNameStyle, getMaxBufferSize, getMessageRetention, getMessageSelection, getMQConnectionOptions, getMsgBatchSize, getMsgCompList, getMulticast, getPollingInterval, getPort, getProviderVersion, getProxyHostName, getProxyPort, getPubAckInterval, getQueueManager, getReceiveExit, getReceiveExitInit, getReference, getRescanInterval, getSecurityExit, getSecurityExitInit, getSendCheckCount, getSendExit, getSendExitInit, getShareConvAllowed, getSparseSubscriptions, getSSLCertStores, getSSLCertStoresAsString, getSSLCipherSuite, getSSLFipsRequired, getSSLPeerName, getSSLResetCount, getSSLSocketFactory, getStatusRefreshInterval, getSubscriptionStore, getSyncpointAllGets, getTargetClientMatching, getTemporaryModel, getTempQPrefix, getTempTopicPrefix, getTransportType, getUseConnectionPooling, getVersion, getWildcardFormat, setAppName, setAsyncExceptions, setBrokerCCSubQueue, setBrokerControlQueue, setBrokerPubQueue, setBrokerQueueManager, setBrokerSubQueue, setBrokerVersion, setCCDTURL, setCCSID, setChannel, setCleanupInterval, setCleanupLevel, setClientId, setClientID, setClientReconnectOptions, setClientReconnectTimeout, setConnectionNameList, setConnTag, setDescription, setDirectAuth, setFailIfQuiesce, setHdrCompList, setHostName, setLocalAddress, setMapNameStyle, setMaxBufferSize, setMessageRetention, setMessageSelection, setMQConnectionOptions, setMsgBatchSize, setMsgCompList, setMulticast, setPollingInterval, setPort, setProviderVersion, setProxyHostName, setProxyPort, setPubAckInterval, setQueueManager, setReceiveExit, setReceiveExitInit, setRescanInterval, setSecurityExit, setSecurityExitInit, setSendCheckCount, setSendExit, setSendExitInit, setShareConvAllowed, setSparseSubscriptions, setSSLCertStores, setSSLCertStores, setSSLCipherSuite, setSSLFipsRequired, setSSLPeerName, setSSLResetCount, setSSLSocketFactory, setStatusRefreshInterval, setSubscriptionStore, setSyncpointAllGets, setTargetClientMatching, setTemporaryModel, setTempQPrefix, setTempTopicPrefix, setTransportType, setUseConnectionPooling, setWildcardFormat

Methods inherited from class com.ibm.msg.client.jms.admin.JmsConnectionFactoryImpl

createContext, createContext, createContext, createContext, equals, hashCode

Methods inherited from class com.ibm.msg.client.jms.internal.JmsPropertyContextImpl

clear, containsKey, containsValue, entrySet, get, getObjectProperty, isEmpty, keySet, propertyExists, put, putAll, remove, setBatchProperties, setBooleanProperty, setByteProperty, setBytesProperty, setCharProperty, setDoubleProperty, setFloatProperty, setIntProperty, setLongProperty, setObjectProperty, setProviderPropertyContext, setShortProperty, setStringProperty, size, values

Methods inherited from class com.ibm.msg.client.jms.internal.JmsReadablePropertyContextImpl

dump, getBooleanProperty, getByteProperty, getBytesProperty, getCharProperty, getDoubleProperty, getFloatProperty, getIntProperty, getLongProperty, getPropertyNames, getShortProperty, getStringProperty, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.ibm.msg.client.jms.JmsPropertyContext

setBatchProperties, setBooleanProperty, setByteProperty, setBytesProperty, setCharProperty, setDoubleProperty, setFloatProperty, setIntProperty, setLongProperty, setObjectProperty, setShortProperty, setStringProperty

Methods inherited from interface com.ibm.msg.client.jms.JmsReadablePropertyContext

getBooleanProperty, getByteProperty, getBytesProperty, getCharProperty, getDoubleProperty, getFloatProperty, getIntProperty, getLongProperty, getObjectProperty, getPropertyNames, getShortProperty, getStringProperty, propertyExists

Methods inherited from interface java.util.Map

clear, containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, put, putAll, remove, size, values

Methods inherited from interface javax.jms.ConnectionFactory

createConnection, createConnection, createContext, createContext, createContext, createContext

Constructor Detail

MQXAConnectionFactory

public MQXAConnectionFactory()

Default constructor.

Method Detail

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 the JMS provider fails to create an XA connection due to some internal error.

javax.jms.JMSSecurityException - if client authentication fails due to invalid user name or password.

See Also:

XAConnectionFactory.createXAConnection()

createXAConnection

public javax.jms.XAConnection createXAConnection(java.lang.String userid,
                                        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:

userid - 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.

See Also:

XAConnectionFactory.createXAConnection(java.lang.String, java.lang.String)

createXAContext

public javax.jms.XAJMSContext createXAContext()
                                       throws javax.jms.JMSRuntimeException,
                                              javax.jms.JMSSecurityRuntimeException

Specified by:

createXAContext in interface javax.jms.XAConnectionFactory

Throws:

javax.jms.JMSRuntimeException

javax.jms.JMSSecurityRuntimeException

See Also:

XAConnectionFactory.createXAContext()

createXAContext

public javax.jms.XAJMSContext createXAContext(java.lang.String userName,
                                     java.lang.String password)
                                       throws javax.jms.JMSRuntimeException,
                                              javax.jms.JMSSecurityRuntimeException

Specified by:

createXAContext in interface javax.jms.XAConnectionFactory

Throws:

javax.jms.JMSRuntimeException

javax.jms.JMSSecurityRuntimeException

See Also:

XAConnectionFactory.createXAContext(java.lang.String, java.lang.String)