Advanced Queuing - Oracle

The Internet Data Access Presentation (IDAP)
Table 17–1 Client Requests for Enqueue—Arguments and Attributes for AQXmlSend and AQXmlPublish
Argument Attribute
- expiration—duration in seconds that a message is available for dequeuing.
This parameter is an offset from the delay. By default messages never expire.
If the message is not dequeued before it expires, then it is moved to the exception
queue in the EXPIRED state
- delay—duration in seconds after which a message is available for processing
- priority—the priority of the message. A smaller number indicates higher
priority. The priority can be any number, including negative numbers.
- sender_id—the application-specified identifier
agent_name, address, protocol
agent_alias—if specified, resolves to a name, address, protocol using
LDAP
- recipient_list—list of recipients; overrides the default subscriber list. Each
recipient consists of:
agent_name, address, protocol
agent_alias—if specified, resolves to a name, address, protocol using
LDAP
- message_state— state of the message is filled in automatically during dequeue
0: The message is ready to be processed.
1: The message delay has not yet been reached.
2: The message has been processed and is retained.
3: The message has been moved to the exception queue.
- exception_queue—in case of exceptions the name of the queue to which the
message is moved if it cannot be processed successfully. Messages are moved in
two cases: The number of unsuccessful dequeue attempts has exceeded max_
retries or the message has expired. All messages in the exception queue are in
the EXPIRED state.
The default is the exception queue associated with the queue table. If the
exception queue specified does not exist at the time of the move, then the message
is moved to the default exception queue associated with the queue table, and a
warning is logged in the alert file. If the default exception queue is used, then the
parameter returns a NULL value at dequeue time.
message_payload this can have different sub-elements based on the payload type of the destination
queue/topic. The different payload types are described in the next section
AQXmlCommit this is an empty element—if specified, the user transaction is committed at the end
of the request
17-8 Oracle9i Application Developer’s Guide - Advanced Queuing