Advanced Queuing - Oracle

The Internet Data Access Presentation (IDAP)
Table 17–3 Client Requests for Dequeue—Arguments and Attributes for AQXmlReceive
Argument Attribute
consumer_options destination—specify the queue/topic from which messages are to be
received. The destination element has an attribute lookup_type which
determines how the destination element value is interpreted
DATABASE (default)—destination is interpreted as
schema.queue_name
LDAP—the LDAP server is used to resolve the destination
- consumer_name—Name of the consumer. Only those messages matching
the consumer name are accessed. If a queue is not set up for multiple
consumers, then this field should not be specified
- wait_time—the time (in seconds) to wait if there is currently no message
available which matches the search criteria
- selector—criteria used to select the message, specified as one of:
- visibility
correlation—the correlation identifier of the message to be
dequeued.
message_id— the message identifier of the message to be dequeued
condition—dequeue message that satisfy this condition.
A condition is specified as a Boolean expression using syntax similar to the
WHERE clause of a SQL query. This Boolean expression can include
conditions on message properties, user data properties (object payloads
only), and PL/SQL or SQL functions (as specified in the where clause of a
SQL query). Message properties include priority, corrid and other
columns in the queue table
To specify dequeue conditions on a message payload (object payload), use
attributes of the object type in clauses. You must prefix each attribute with
tab.user_data as a qualifier to indicate the specific column of the queue
table that stores the payload. The deq_condition parameter cannot exceed
4000 characters.
ON_COMMIT (default)—The dequeue is part of the current transaction.
The operation is complete when the transaction commits.
IMMEDIATE—effects of the dequeue are visible immediately after the
request is completed. The dequeue is not part of the current transaction.
The operation constitutes a transaction on its own.
Internet Access to Advanced Queuing 17-21