Advanced Queuing - Oracle

JMS Message Producer Features
The message grouping property is preserved across propagation. However, it is
important to note that the destination topic to which messages have to be
propagated must also be enabled for transactional grouping. There are also some
restrictions you need to keep in mind if the message grouping property is to be
preserved while dequeuing messages from a queue enabled for transactional
grouping (see “Dequeue Methods" and "Modes of Dequeuing" for additional
information).
Example Scenario
In the BooksOnLine application, message grouping can be used to handle new
orders. Each order contains a number of books ordered one by one in succession.
Items ordered over the Web exhibit similar behavior.
In the example that follows, each send corresponds to an individual book that is
part of an order, and the group/transaction represents a complete order. Only the
first message contains customer information. Note that the OE_neworders_que is
defined in the queue table OE_orders_sqtab which has been enabled for
transactional grouping.
Example Code
public static void createMsgGroupQueueTable(QueueSession jms_session)
{
AQQueueTableProperty sqt_prop;
AQQueueTable sq_table;
AQjmsDestinationProperty dest_prop;
Queue neworders_q;
try
{
/* Create a single-consumer orders queue table
* with message grouping = TRANSACTIONAL
*/
sqt_prop = new AQQueueTableProperty("BOLADM.order_typ");
sqt_prop.setComment("Order Entry Single-Consumer Orders queue table");
sqt_prop.setCompatible("8.1");
sqt_prop.setMessageGrouping(AQQueueTableProperty.TRANSACTIONAL);
sq_table = ((AQjmsSession)jms_session).createQueueTable("OE",
"OE_orders_sqtab", sqt_prop);
/* Create new orders queue for OE */
dest_prop = new AQjmsDestinationProperty();
neworders_q = ((AQjmsSession)jms_session).createQueue(sq_table,
Creating Applications Using JMS 12-63