javax.jms
Interface XAQueueConnectionFactory

public interface XAQueueConnectionFactory

extends XAConnectionFactory, QueueConnectionFactory

An XAQueueConnectionFactory provides the same create options as a QueueConnectionFactory (optional).

Version:

1.0 - 14 May 1998

Author:

Mark Hapner, Rich Burridge

See Also:

QueueConnectionFactory, XAConnectionFactory

Method Summary

XAQueueConnection	createXAQueueConnection() Create an XA queue connection with default user identity.
XAQueueConnection	createXAQueueConnection(java.lang.String userName, java.lang.String password) Create an XA queue connection with specific user identity.

Methods inherited from interface javax.jms.QueueConnectionFactory

createQueueConnection, createQueueConnection

Method Detail

createXAQueueConnection

public XAQueueConnection createXAQueueConnection()
                                          throws JMSException

Create an XA queue connection with default user identity. The connection is created in stopped mode. No messages will be delivered until Connection.start method is explicitly called.

Returns:

a newly created XA queue connection.

Throws:

JMSException - if JMS Provider fails to create XA queue Connection due to some internal error.

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

createXAQueueConnection

public XAQueueConnection createXAQueueConnection(java.lang.String userName,
                                                 java.lang.String password)
                                          throws JMSException

Create an XA queue connection with specific user identity. The connection is created in stopped mode. No messages will be delivered until Connection.start method is explicitly called.

Parameters:

userName - the caller's user name

password - the caller's password

Returns:

a newly created XA queue connection.

Throws:

JMSException - if JMS Provider fails to create XA queue Connection due to some internal error.

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