Advanced Queuing - Oracle

JMS Message Consumer Features
The message was received successfully. However, because of an error while
processing the message, the application aborts the transaction that performed
the receive. The message is returned to the queue/topic and will be available
for any applications that are waiting to receive messages. Since this was a failed
attempt to receive the message, its retry count is updated.
If the retry count of the message exceeds the maximum value specified for the
queue/topic where it resides, it is moved to the exception queue. When a
message has multiple subscribers, then the message is moved to the exception
queue only when all the recipients of the message have exceeded the retry limit.
A receive is considered rolled back or undone if the application aborts the entire
transaction, or if it rolls back to a savepoint that was taken before the receive.
The client program successfully received a message but terminated before
committing the transaction.
Example Scenarios
The section retry with delay interval has an example with MAX_RETRIES. In the
BooksOnLine application, the business rule for each shipping region is that an order
will be placed in a back order queue if the order cannot be filled immediately. The
back order application will try to fill the order once a day. If the order cannot be
filled within 7 days, it is placed in an exception queue for special processing. We
implement this using the Time-to-Live property of messages in conjunction with
exception queues.
1. Create the exception queue WS_back_order_exp_que
public void create_excp_que(TopicSession jms_session)
{
AQQueueTable q_table;
Queue excpq;
try {
/* create the exception queue in the queue table with multiple
* consumer flag true
*/
q_table = ((AQjmsSession)jms_session).getQueueTable("WS", "WS_orders_
mqtab");
AQjmsDestinationProperty dest_prop = new AQjmsDestinationProperty();
dest_prop.setQueueType(AQjmsDestinationProperty.EXCEPTION_QUEUE);
excpq = ((AQjmsSession)jms_session).createQueue(q_table,
"WS_back_orders_excp_que",
Creating Applications Using JMS 12-81