1. /*

  2.  * Copyright 2002 Sun Microsystems, Inc. All rights reserved.

  3.  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

  4.  */

  5. 

  6. package javax.jms;

  7. 

  8. /** An <CODE>XAQueueConnection</CODE> provides the same create options as 

  9.   * <CODE>QueueConnection</CODE> (optional).  

  10.   * The only difference is that an <CODE>XAConnection</CODE> is by definition 

  11.   * transacted.

  12.   *

  13.   * @version     1.0 - 13 March 1998

  14.   * @author      Mark Hapner

  15.   * @author      Rich Burridge

  16.   *

  17.   * @see         javax.jms.XAConnection

  18.   */

  19. 

  20. public interface XAQueueConnection 

  21. 	extends XAConnection, QueueConnection {

  22. 

  23.     /** Creates an <CODE>XAQueueSession</CODE> object.

  24.       *  

  25.       * @return a newly created <CODE>XAQueueSession</CODE>

  26.       *  

  27.       * @exception JMSException if the <CODE>XAQueueConnection</CODE> object 

  28.       *                         fails to create an XA queue session due to some

  29.       *                         internal error.

  30.       */ 

  31. 

  32.     XAQueueSession

  33.     createXAQueueSession() throws JMSException;

  34. 

  35.     /** Creates an <CODE>XAQueueSession</CODE> object.

  36.       *

  37.       * @param transacted       usage undefined

  38.       * @param acknowledgeMode  usage undefined

  39.       *  

  40.       * @return a newly created <CODE>XAQueueSession</CODE>

  41.       *  

  42.       * @exception JMSException if the <CODE>XAQueueConnection</CODE> object 

  43.       *                         fails to create an XA queue session due to some

  44.       *                         internal error.

  45.       */ 

  46.     QueueSession

  47.     createQueueSession(boolean transacted,

  48.                        int acknowledgeMode) throws JMSException;

  49. }