Canceling QAnywhere messages

Canceling a QAnywhere message puts the message into a canceled state before it is transmitted. With the default delete rules of the QAnywhere Agent, canceled messages are eventually deleted from the message store. Canceling a QAnywhere message fails if the message is already in a final state, or if it has been transmitted to the central messaging server.

The following procedures describe how to cancel QAnywhere messages.

Note

You cannot cancel a message using the QAnywhere SQL API.

Cancel a message (.NET)

Get the ID of the message to cancel.

// msg is a QAMessage instance that has not been 
// transmitted.
string msgID = msg.getMessageID();

Call CancelMessage with the ID of the message to cancel.
mgr.CancelMessage(msgID);

Cancel a message (C++)

Get the ID of the message to cancel.

// msg is a QAMessage instance that has not been 
// transmitted.
qa_string msgID = msg->getMessageID();

Call cancelMessage with the ID of the message to cancel.
bool result = mgr->cancelMessage(msgID);

Cancel a message (Java)

Get the ID of the message to cancel.

// msg is a QAMessage instance that has not been 
// transmitted.
String msgID = msg.getMessageID();

Call cancelMessage with the ID of the message to cancel.
boolean result = mgr.cancelMessage(msgID);