QAException class

Encapsulates QAnywhere client application exceptions.

Visual Basic syntax

Public MustInherit Class QAException Inherits System.Exception

C# syntax

public abstract class QAException : System.Exception

Base classes

Members

All members of QAException class, including all inherited members.

Name	Description
GetBaseException method (Inherited from System.Exception)	When overridden in a derived class, returns the System.Exception that is the root cause of one or more subsequent exceptions.
GetObjectData method (Inherited from System.Exception)	When overridden in a derived class, sets the System.Runtime.Serialization.SerializationInfo with information about the exception.
GetType method (Inherited from System.Exception)	Gets the runtime type of the current instance.
ToString method (Inherited from System.Exception)	Creates and returns a string representation of the current exception.
Data property (Inherited from System.Exception)	Gets a collection of key/value pairs that provide additional user-defined information about the exception.
DetailedMessage property	The detailed error message of the exception.
ErrorCode property	The error code of the exception.
HelpLink property (Inherited from System.Exception)	Gets or sets a link to the help file associated with this exception.
HResult property (Inherited from System.Exception)	Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.
InnerException property (Inherited from System.Exception)	Gets the System.Exception instance that caused the current exception.
Message property (Inherited from System.Exception)	Gets a message that describes the current exception.
NativeErrorCode property	The native error code of the exception.
Source property (Inherited from System.Exception)	Gets or sets the name of the application or the object that causes the error.
StackTrace property (Inherited from System.Exception)	Gets a string representation of the frames on the call stack at the time the current exception was thrown.
TargetSite property (Inherited from System.Exception)	Gets the method that throws the current exception.
COMMON_ALREADY_OPEN_ERROR field	The QAManager is already open.
COMMON_GET_INIT_FILE_ERROR field	Unable to access the client properties file.
COMMON_GET_PROPERTY_ERROR field	Error retrieving property from message store.
COMMON_GETQUEUEDEPTH_ERROR field	Error getting the queue depth.
COMMON_GETQUEUEDEPTH_ERROR_INVALID_ARG field	Cannot use QAManagerBase.getQueueDepth on a given destination when filter is ALL.
COMMON_GETQUEUEDEPTH_ERROR_NO_STORE_ID field	Cannot use %QAManagerBase.getQueueDepth when the message store ID has not been set.
COMMON_INIT_ERROR field	Initialization error.
COMMON_INIT_THREAD_ERROR field	Error initializing the background thread.
COMMON_INVALID_PROPERTY field	There is an invalid property in the client properties file.
COMMON_MSG_ACKNOWLEDGE_ERROR field	Error acknowledging the message.
COMMON_MSG_CANCEL_ERROR field	Error cancelling message.
COMMON_MSG_CANCEL_ERROR_SENT field	Error cancelling message.
COMMON_MSG_NOT_WRITEABLE_ERROR field	You cannot write to a message that is in read-only mode.
COMMON_MSG_RETRIEVE_ERROR field	Error retrieving a message from the client message store.
COMMON_MSG_STORE_ERROR field	Error storing a message in the client message store.
COMMON_MSG_STORE_NOT_INITIALIZED field	The message store has not been initialized for messaging.
COMMON_MSG_STORE_TOO_LARGE field	The message store is too large relative to the free disk space on the device.
COMMON_NO_DEST_ERROR field	No destination.
COMMON_NO_IMPLEMENTATION field	The method is not implemented.
COMMON_NOT_OPEN_ERROR field	The QAManager is not open.
COMMON_OPEN_ERROR field	Error opening a connection to the message store.
COMMON_OPEN_LOG_FILE_ERROR field	Error opening the log file.
COMMON_OPEN_MAXTHREADS_ERROR field	Cannot open the QAManager because the maximum number of concurrent server requests is not high enough (see database server -gn option).
COMMON_REOPEN_ERROR field	Error re-opening connection to message store.
COMMON_SELECTOR_SYNTAX_ERROR field	The given selector has a syntax error.
COMMON_SET_PROPERTY_ERROR field	Error storing property to message store.
COMMON_TERMINATE_ERROR field	Termination error.
COMMON_UNEXPECTED_EOM_ERROR field	Unexpected end of message reached.
COMMON_UNREPRESENTABLE_TIMESTAMP field	The timestamp is outside of the acceptable range.
QA_NO_ERROR field	No error.

Remarks

Example

The following method uses the QAException class to catch QAnywhere exceptions:

public static void startReceiver() {
    _mainWindow._messageList.Items.Clear();
    _mainWindow._detailWindow.Text = "";

    try {
  	    _qaManager = QAManagerFactory.Instance.CreateQAManager(null);
  	    _qaManager.Open(AcknowledgementMode.EXPLICIT_ACKNOWLEDGEMENT);
  	    _qaManager.Start();
  	    _mainWindow.loadMessages();
  	    _qaManager.SetMessageListener(Options.getReceiveQueueName(),_receiveListener);
  	    _qaManager.SetMessageListener("system", _systemListener);
    }
    catch(QAException e) {
  	    MessageBox.Show("Error code: " + e.ErrorCode );
  	    MessageBox.Show("Error message: " + e.Message );
    }
}

Discuss this page in DocCommentXchange.