SetMessageListenerBySelector method

Sets a MessageListener delegate to receive QAnywhere messages asynchronously, with a message selector. See MessageListener delegate.

Syntax
Visual Basic
Public Sub SetMessageListenerBySelector( _
   ByVal address As String, _
   ByVal selector As String, _
   ByVal listener As MessageListener _
)
C#
public void SetMessageListenerBySelector(
   string  address,
   string  selector,
   MessageListener listener
);
Parameters
  • address   The address of messages.

  • listener   The listener to register.

  • selector   The selector to be used to filter the messages to be received.

Remarks

Use this method to receive message asynchronously.

MessageListener delegate accepts a single QAMessage parameter.

The SetMessageListener address parameter specifies a local queue name used to receive the message. You can only have one listener delegate assigned to a given queue. The selector parameter specifies a selector to be used to filter the messages to be received on the given address. You may set an ExceptionListener and a MessageListener for a given address, but you must be consistent with the Listener/Listener2 delegates. That is, you cannot set an ExceptionListener and a MessageListener2, nor an ExceptionListener2 and a MessageListener, for the same address.

If you want to listen for QAnywhere system messages, including push notifications and network status changes, specify system as the queue name.

For more information, see Receiving messages asynchronously and System queue.

See also