QAException class

Encapsulates QAnywhere client application exceptions.

Syntax

public class QAException

Members

All members of QAException class, including all inherited members.

Name	Description
getDetailedMessage method	Returns the detailed text description of the exception.
getErrorCode method	Returns the error code of the last exception.
getNativeErrorCode method	Returns the native error code of the last exception.
COMMON_ALREADY_OPEN_ERROR variable	The QAManager is already open.
COMMON_GET_INIT_FILE_ERROR variable	Unable to access the client properties file.
COMMON_GET_PROPERTY_ERROR variable	Error retrieving property from message store.
COMMON_GETQUEUEDEPTH_ERROR variable	Error getting the queue depth.
COMMON_GETQUEUEDEPTH_ERROR_INVALID_ARG variable	Cannot use QAManagerBase.getQueueDepth on a given destination when filter is ALL.
COMMON_GETQUEUEDEPTH_ERROR_NO_STORE_ID variable	Cannot use QAManagerBase.getQueueDepth when the message store ID has not been set.
COMMON_INIT_ERROR variable	Initialization error.
COMMON_INIT_THREAD_ERROR variable	Error initializing the background thread.
COMMON_INVALID_PROPERTY variable	There is an invalid property in the client properties file.
COMMON_MSG_ACKNOWLEDGE_ERROR variable	Error acknowledging the message.
COMMON_MSG_CANCEL_ERROR variable	Error cancelling message.
COMMON_MSG_CANCEL_ERROR_SENT variable	Error cancelling message.
COMMON_MSG_NOT_WRITEABLE_ERROR variable	You cannot write to a message that is in read-only mode.
COMMON_MSG_RETRIEVE_ERROR variable	Error retrieving a message from the client message store.
COMMON_MSG_STORE_ERROR variable	Error storing a message in the client message store.
COMMON_MSG_STORE_NOT_INITIALIZED variable	The message store has not been initialized for messaging.
COMMON_MSG_STORE_TOO_LARGE variable	The message store is too large relative to the free disk space on the device.
COMMON_NO_DEST_ERROR variable	No destination.
COMMON_NO_IMPLEMENTATION variable	The method is not implemented.
COMMON_NOT_OPEN_ERROR variable	The QAManager is not open.
COMMON_OPEN_ERROR variable	Error opening a connection to the message store.
COMMON_OPEN_LOG_FILE_ERROR variable	Error opening the log file.
COMMON_OPEN_MAXTHREADS_ERROR variable	Cannot open the QAManager because the maximum number of concurrent server requests is not high enough (see database server -gn option).
COMMON_REOPEN_ERROR variable	Error re-opening connection to message store.
COMMON_SELECTOR_SYNTAX_ERROR variable	The given selector has a syntax error.
COMMON_SET_PROPERTY_ERROR variable	Error storing property to message store.
COMMON_TERMINATE_ERROR variable	Termination error.
COMMON_UNEXPECTED_EOM_ERROR variable	Unexpected end of message reached.
COMMON_UNREPRESENTABLE_TIMESTAMP variable	The timestamp is outside of the acceptable range.
QA_NO_ERROR variable	No error.

Remarks

You can use the QAException class to catch QAnywhere exceptions.

The following example catches a QAnywhere exception:

  try
  {
  	_qaManager = QAManagerFactory.getInstance().CreateQAManager();
  	_qaManager.open( AcknowledgementMode.EXPLICIT_ACKNOWLEDGEMENT );
  	_qaManager.start();
  }
  catch( QAException e )
  {
  	// Handle exception.
  	System.err.println("Error code: " + e.getErrorCode() );
  	System.err.println("Error message: " + e.getMessage() );
  }
}

Discuss this page in DocCommentXchange.