com.ibm.etill.framework.log
Class ETillRuntimeException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--java.lang.RuntimeException
                    |
                    +--com.ibm.etill.framework.log.ETillRuntimeException
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
ETillCassetteException, ETillFrameworkException, ETillInitException

public class ETillRuntimeException
extends RuntimeException

ETillRuntimeException is the base class for exceptions that terminate one or more running Payment Server components.

If an ETillRuntimeException object (that is, an instance of this class and not one of its subclasses) is thrown, it will cause the Payment Server to shutdown. Cassettes may throw this exception in extreme, unrecoverable situations. In order to terminate just a cassette, throw an ETillCassetteException, which extends this class.

See Also:
Serialized Form

Field Summary
static int RE_CASSETTE_ERROR
           
static int RE_FRAMEWORK_ERROR
           
static int RE_INIT_ERROR
           
static int RE_RUNTIME_ERROR
           
 
Constructor Summary
ETillRuntimeException()
          Constructs an ETillRuntimeException.
ETillRuntimeException(String message)
          Constructs an ETillRuntimeException with text to be displayed at the console.
 
Method Summary
 Cassette getCassette()
          This method always returns null for instances of this class.
 int getPrimaryErrorCode()
          Returns the system termination code representing this exception.
 int getSecondaryErrorCode()
          Returns the secondary return code associated with the error.
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getMessage, printStackTrace, printStackTrace, printStackTrace, toString
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

RE_RUNTIME_ERROR

public static final int RE_RUNTIME_ERROR

RE_INIT_ERROR

public static final int RE_INIT_ERROR

RE_FRAMEWORK_ERROR

public static final int RE_FRAMEWORK_ERROR

RE_CASSETTE_ERROR

public static final int RE_CASSETTE_ERROR
Constructor Detail

ETillRuntimeException

public ETillRuntimeException(String message)
Constructs an ETillRuntimeException with text to be displayed at the console.
Parameters:
message - a String containing the text to display.

ETillRuntimeException

public ETillRuntimeException()
Constructs an ETillRuntimeException. If this exception is thrown, the text "violated internal assertion" will be displayed at the console.
Method Detail

getPrimaryErrorCode

public int getPrimaryErrorCode()
Returns the system termination code representing this exception. This code varies per subclass.
Returns:
int - the termination code. For instances of this class, RE_RUNTIME_ERROR is always returned.

getSecondaryErrorCode

public int getSecondaryErrorCode()
Returns the secondary return code associated with the error.
Returns:
int - the secondary return code.

getCassette

public Cassette getCassette()
This method always returns null for instances of this class.
Returns:
Cassette - always a null value