Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| JavaTM 2 Platform Std. Ed. v1.4.1
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## javax.transaction.xa
Class XAException

    java.lang.Object
      |
      +--java.lang.Throwable
            |
            +--java.lang.Exception
                  |
                  +--javax.transaction.xa.XAException

All Implemented Interfaces:
  Serializable

public class XAException
extends Exception

The XAException is thrown by the Resource Manager (RM) to inform the Transaction Manager of an error encountered by the involved transaction.

See Also:
  Serialized Form

Field Summary
`int` | `errorCode` The error code with which to create the SystemException.
`static int` | `XA_HEURCOM` The transaction branch has been heuristically committed.
`static int` | `XA_HEURHAZ` The transaction branch may have been heuristically completed.
`static int` | `XA_HEURMIX` The transaction branch has been heuristically committed and rolled back.
`static int` | `XA_HEURRB` The transaction branch has been heuristically rolled back.
`static int` | `XA_NOMIGRATE` Resumption must occur where the suspension occurred.
`static int` | `XA_RBBASE` The inclusive lower bound of the rollback codes.
`static int` | `XA_RBCOMMFAIL` Indicates that the rollback was caused by a communication failure.
`static int` | `XA_RBDEADLOCK` A deadlock was detected.
`static int` | `XA_RBEND` The inclusive upper bound of the rollback error code.
`static int` | `XA_RBINTEGRITY` A condition that violates the integrity of the resource was detected.
`static int` | `XA_RBOTHER` The resource manager rolled back the transaction branch for a reason not on this list.
`static int` | `XA_RBPROTO` A protocol error occurred in the resource manager.
`static int` | `XA_RBROLLBACK` Indicates that the rollback was caused by an unspecified reason.
`static int` | `XA_RBTIMEOUT` A transaction branch took too long.
`static int` | `XA_RBTRANSIENT` May retry the transaction branch.
`static int` | `XA_RDONLY` The transaction branch was read-only and has been committed.
`static int` | `XA_RETRY` Routine returned with no effect and may be reissued.
`static int` | `XAER_ASYNC` There is an asynchronous operation already outstanding.
`static int` | `XAER_DUPID` The XID already exists.
`static int` | `XAER_INVAL` Invalid arguments were given.
`static int` | `XAER_NOTA` The XID is not valid.
`static int` | `XAER_OUTSIDE` The resource manager is doing work outside a global transaction.
`static int` | `XAER_PROTO` Routine was invoked in an inproper context.
`static int` | `XAER_RMERR` A resource manager error has occurred in the transaction branch.
`static int` | `XAER_RMFAIL` Resource manager is unavailable.

Constructor Summary
`XAException()` Create an XAException.
`XAException(int errcode)` Create an XAException with a given error code.
`XAException(String s)` Create an XAException with a given string.

Methods inherited from class java.lang.Throwable
`fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

Field Detail

### errorCode

    public int errorCode

  The error code with which to create the SystemException.

### XA_RBBASE

    public static final int XA_RBBASE

  The inclusive lower bound of the rollback codes.

  See Also:
    Constant Field Values

### XA_RBROLLBACK

    public static final int XA_RBROLLBACK

  Indicates that the rollback was caused by an unspecified reason.

  See Also:
    Constant Field Values

### XA_RBCOMMFAIL

    public static final int XA_RBCOMMFAIL

  Indicates that the rollback was caused by a communication failure.

  See Also:
    Constant Field Values

### XA_RBDEADLOCK

    public static final int XA_RBDEADLOCK

  A deadlock was detected.

  See Also:
    Constant Field Values

### XA_RBINTEGRITY

    public static final int XA_RBINTEGRITY

  A condition that violates the integrity of the resource was detected.

  See Also:
    Constant Field Values

### XA_RBOTHER

    public static final int XA_RBOTHER

  The resource manager rolled back the transaction branch for a reason not on this list.

  See Also:
    Constant Field Values

### XA_RBPROTO

    public static final int XA_RBPROTO

  A protocol error occurred in the resource manager.

  See Also:
    Constant Field Values

### XA_RBTIMEOUT

    public static final int XA_RBTIMEOUT

  A transaction branch took too long.

  See Also:
    Constant Field Values

### XA_RBTRANSIENT

    public static final int XA_RBTRANSIENT

  May retry the transaction branch.

  See Also:
    Constant Field Values

### XA_RBEND

    public static final int XA_RBEND

  The inclusive upper bound of the rollback error code.

  See Also:
    Constant Field Values

### XA_NOMIGRATE

    public static final int XA_NOMIGRATE

  Resumption must occur where the suspension occurred.

  See Also:
    Constant Field Values

### XA_HEURHAZ

    public static final int XA_HEURHAZ

  The transaction branch may have been heuristically completed.

  See Also:
    Constant Field Values

### XA_HEURCOM

    public static final int XA_HEURCOM

  The transaction branch has been heuristically committed.

  See Also:
    Constant Field Values

### XA_HEURRB

    public static final int XA_HEURRB

  The transaction branch has been heuristically rolled back.

  See Also:
    Constant Field Values

### XA_HEURMIX

    public static final int XA_HEURMIX

  The transaction branch has been heuristically committed and rolled back.

  See Also:
    Constant Field Values

### XA_RETRY

    public static final int XA_RETRY

  Routine returned with no effect and may be reissued.

  See Also:
    Constant Field Values

### XA_RDONLY

    public static final int XA_RDONLY

  The transaction branch was read-only and has been committed.

  See Also:
    Constant Field Values

### XAER_ASYNC

    public static final int XAER_ASYNC

  There is an asynchronous operation already outstanding.

  See Also:
    Constant Field Values

### XAER_RMERR

    public static final int XAER_RMERR

  A resource manager error has occurred in the transaction branch.

  See Also:
    Constant Field Values

### XAER_NOTA

    public static final int XAER_NOTA

  The XID is not valid.

  See Also:
    Constant Field Values

### XAER_INVAL

    public static final int XAER_INVAL

  Invalid arguments were given.

  See Also:
    Constant Field Values

### XAER_PROTO

    public static final int XAER_PROTO

  Routine was invoked in an inproper context.

  See Also:
    Constant Field Values

### XAER_RMFAIL

    public static final int XAER_RMFAIL

  Resource manager is unavailable.

  See Also:
    Constant Field Values

### XAER_DUPID

    public static final int XAER_DUPID

  The XID already exists.

  See Also:
    Constant Field Values

### XAER_OUTSIDE

    public static final int XAER_OUTSIDE

  The resource manager is doing work outside a global transaction.

  See Also:
    Constant Field Values

Constructor Detail

### XAException

    public XAException()

  Create an XAException.

### XAException

    public XAException(String s)

  Create an XAException with a given string.

Parameters:
  `s` - The `String` object containing the exception message.

### XAException

    public XAException(int errcode)

  Create an XAException with a given error code.

Parameters:
  `errcode` - The error code identifying the exception.

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| JavaTM 2 Platform Std. Ed. v1.4.1
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.