In order to create JMS resources such as queues, topics and connection factories you need to create, at first, a JMS Module which acts as a container for these resources.
JMS modules are application-related definitions that are independent of the domain environment.
You create and manage JMS resources either as System modules or as Application modules.
- JMS System modules are typically configured using the Administration Console or the WebLogic Scripting Tool (WLST).
- JMS Application modules are a WebLogic-specific extension of JEE modules and can be deployed along with a JEE application.
Let’s see at first how to create a new JMS System module. In order to do that, perform the following steps:
- Expand the Services label from the left menu and select Messaging | JMS Modules.
- Click New to create a new JMS System Module. In the next screen, choose a Name for the JMS System Module. You can optionally specify a Name and a Location where JMS file descriptors will be saved.
Module file descriptors are pretty useful as a template if you want to deploy your JMS resource at application level
Click Next. In the following screen choose the target servers for your JMS Module:
Check the servers where you want to target your JMS module and click Save.
The last screen contains a check box which lets you add JMS resources (such as JMS Queues) to your newly created JMS System Module.
If you want to associate JMS resources to the module check the above option and click Finish.
In order to create a new JMS resource you need to enter into the JMS module Configuration screen as depicted by the following picture: (If you are arriving from a new JMS module creation, you will be automatically into the JMS module configuration window, otherwise select from the left menu Services | Messaging | JMS Modules and click on your JMS Module)
Click New to add a new resource to the JMS Module. We will show at first how to create a Connection Factory and then how to create a JMS destination.
Connection factories are resources that enable JMS clients to create JMS connections.
From the JMS Module screen, click New and select Connection Factory from the list of resources.
Click Next. In the following screen enter the Connection factory properties:
You need to provide, at least, the mandatory Name and JNDI binding for your Connection factory. Once done, click Finish. At the top of the page, a message will indicate that you have successfully created the Connection Factory which will be mentioned in the Summary view of your JMS resources.
JMS configuration resources such as destinations and connection factories are stored outside of the domain configuration file (config.xml) as module descriptor files of an application. You can find them in the config/jms folder of your domain.