user manual

Chapter 23: Using JMS 247
JMS and Transactions
A dialog box prompts for a JNDI name for JMS object that is to be created.
Once given, a representation of this JMS object appears in the tree in the
Navigation Pane. Click its representation to open its configuration panel.
The DDEditor has knowledge of Tibco and Sonic, and can auto fill the class
names for the appropriate JMS object.
Note The Main panel will not suggest any JMS objects other than Tibco or Sonic.
You need to use the Properties tab to set any appropriate properties.
Use the Properties tab to set any needed properties.
When you're finished, choose "File|Save..." and the module will be saved back
to the Partition and redeployed.
Queue creation
For specific information on queue creation, refer to Chapter 24, “JMS provider
pluggability”.
Enabling Sonic
To enable Sonic:
1 Create a Sonic Managed Object. For information on creating Managed
Objects, refer to the BDOC Developer’s Guide, Managed Objects section.
2 Modify sonic.config in <install_dir>\bin\sonic.config to include the Sonic
home directory.
The JMS home is the Sonic home directory, the root directory of the Sonic
install, JMS.home = <sonic home>. The default is blank.
JMS and Transactions
The way to use JMS APIs in a transaction is detailed in the EJB 2.0
specification section 17.3.5.
17.3.5 Use of JMS APIs in transactions
The Bean Provider must not make use of the JMS request/reply paradigm
(sending of a JMS message, followed by the synchronous receipt of a reply
to that message) within a single transaction.
Because a JMS message is not delivered to its final destination until the
transaction commits,
the receipt of the reply within the same transaction will never take place.
Because the container
manages the transactional enlistment of JMS sessions on behalf of a bean,
the parameters of the
createQueueSession(boolean transacted,int acknowledgeMode) and
createTopicSession(boolean transacted,
int acknowledgeMode) methods are ignored. It is recommended that the Bean
Provider specify that a