progress.message.jclient.xa
Interface XATopicConnection

All Superinterfaces:

Connection, TopicConnection, XAConnection, XATopicConnection

public interface XATopicConnection
extends XAConnection, XATopicConnection, TopicConnection

An XATopicConnection provides the same create options as TopicConnection (optional). The only difference is that an XAConnection is by definition transacted.

Version:

1.0 - 27 November 2000

Author:

Kathy Guo

See Also:

XAConnection

Method Summary

XATopicSession	createXATopicSession(java.lang.String sessionName) Creates an XATopicSession object with an associated name.
TopicConnection	getTopicConnection() get a TopicConnection associated with this XATopicConnection object.

Methods inherited from interface progress.message.jclient.xa.XAConnection

close, createXASession, getConnection

Methods inherited from interface javax.jms.XAConnection

createSession, createXASession

Methods inherited from interface javax.jms.Connection

createConnectionConsumer, getClientID, getExceptionListener, getMetaData, setClientID, setExceptionListener, start, stop

Methods inherited from interface progress.message.jclient.Connection

createSession, getBrokerReconnectURLs, getBrokerURL, getChannel, getConnectID, getConnectionState, getConnectionStateChangeListener, getRoutingNodeName, getStandbyBrokerReconnectURLs, getUnfinishedChannelIDs, getUnfinishedChannels, getUsername, hasUnfinishedChannel, hasUnfinishedChannels, isFaultTolerant, isSecure, setConnectionStateChangeListener, setPingInterval, setRejectionListener

Methods inherited from interface javax.jms.Connection

createConnectionConsumer, getClientID, getExceptionListener, getMetaData, setClientID, setExceptionListener, start, stop

Methods inherited from interface javax.jms.XATopicConnection

createTopicSession, createXATopicSession

Methods inherited from interface javax.jms.XAConnection

createSession, createXASession

Methods inherited from interface javax.jms.Connection

createConnectionConsumer, getClientID, getExceptionListener, getMetaData, setClientID, setExceptionListener, start, stop

Methods inherited from interface javax.jms.TopicConnection

createConnectionConsumer, createDurableConnectionConsumer

Methods inherited from interface javax.jms.Connection

createConnectionConsumer, getClientID, getExceptionListener, getMetaData, setClientID, setExceptionListener, start, stop

Methods inherited from interface progress.message.jclient.TopicConnection

createTopicSession

Methods inherited from interface progress.message.jclient.Connection

createSession, getBrokerReconnectURLs, getBrokerURL, getChannel, getConnectID, getConnectionState, getConnectionStateChangeListener, getRoutingNodeName, getStandbyBrokerReconnectURLs, getUnfinishedChannelIDs, getUnfinishedChannels, getUsername, hasUnfinishedChannel, hasUnfinishedChannels, isFaultTolerant, isSecure, setConnectionStateChangeListener, setPingInterval, setRejectionListener

Methods inherited from interface javax.jms.Connection

createConnectionConsumer, getClientID, getExceptionListener, getMetaData, setClientID, setExceptionListener, start, stop

Methods inherited from interface javax.jms.TopicConnection

createConnectionConsumer, createDurableConnectionConsumer

Methods inherited from interface javax.jms.Connection

createConnectionConsumer, getClientID, getExceptionListener, getMetaData, setClientID, setExceptionListener, start, stop

Method Detail

createXATopicSession

XATopicSession createXATopicSession(java.lang.String sessionName)
                                    throws JMSException

Creates an XATopicSession object with an associated name.

Parameters:

sessionName - provides a name for the session; this is an informational label to help administrators identify the session, particularly in the Sonic management tools

Returns:

a newly created XATopicSession

Throws:

JMSException - if the XATopicConnection object fails to create an XATopicSession due to some internal error.

See Also:

Session.getSessionName()

getTopicConnection

TopicConnection getTopicConnection()
                                   throws JMSException

get a TopicConnection associated with this XATopicConnection object. There is one TopicConnection per XATopicConnection at any time. If the TopicConnection was closed, this method create another TopicConnection.

Returns:

a TopicConnection.

Throws:

JMSException - if JMS implementation fails to get the TopicConnection due to internal error.