browseQueue procedure

Allows applications to view messages in a queue without consuming them.

Syntax

PROCEDURE browseQueue. 
DEFINE INPUT PARAMETER queueName AS CHARACTER. 
DEFINE INPUT PARAMETER messageSelector AS CHARACTER.
DEFINE INPUT PARAMETER messageConsumer AS HANDLE.

Parameters

queueName
The queue from which the messages are received.
messageSelector
A message selector.
messageConsumer
A Message Consumer object, which handles the messages asynchronously.

Applies to

Session objects

Notes

  • This procedure receives (for browsing) all messages currently in the queue in the messageConsumer object.
  • Browsed messages are not removed from the queue or acknowledged and are not subject to the transactional context of the session. (For more information, see the Java Message Service specification and the SonicMQ Programming Guide on queue browsing.)
  • The session need not run startReceiveMessages procedure to browse messages on a queue.
  • This procedure executes remotely (sends a message to the OpenEdge Adapter for SonicMQ).

See also

browseQueue procedure, receiveFromQueue procedure , sendToQueue procedure

For more information, see theSending messages to a queue, the Receiving messages from a queue, and the Methods unique to Point-to-Point messaging.

For an example, see the PTP message example.