JMS (Java Messaging Service) resources provides J2EE connection factories to create connections for the JMS destinations in ALBPM. The following procedure documents how to add JMS resources to WebSphere.
To add JMS resources to WebSphere:
If the WebSphere server has not been started, choose Start | All Programs | IBM WebSphere | Application Server | Profiles | profile-name | Start the Server.
To launch the WebSphere Administrative Console, choose Start | All Programs | IBM WebSphere | Application Server | Profiles | profile-name | Administrative Console. You can also launch the console directly from a browser (http://host:port/ibm/console).
Enter your User ID and click Log in.
Add a service integration bus:
In the left pane of the Administrative Console, click Service Integration | Buses.
In the right pane, on the Buses page, click New.
On the Buses | New page, enter a Name for the bus and click OK.
Add a bus member to the service integration bus:
In the left pane, click Service Integration | Buses.
In the right pane, on the Buses page, click the bus Name previously created.
On the Buses | bus-name page, under Additional Properties, click Bus Members.
On the Buses | bus-name | Bus Members page, click Add.
On the Add a New Bus Member page, select the server where the application will be deployed (such as server1) and click Next.
Confirm the new bus member properties and click Finish.
Add a queue destination for the service integration bus:
In the left pane, click Service Integration | Buses.
In the right pane, on the Buses page, click the bus Name just created.
On the Buses | bus-name page, under Additional Properties, click Destinations.
On the Buses | bus-name | Destinations page, click New.
On the Create a New Destination page, select Queue and click Next.
On the Create New Queue page (Step 1), in the Identifier field, enter ToDoQueue and click Next.
On the Create New Queue page (Step 2), select the Bus Member previously created and click Next.
On the Create New Queue page (Step 3), confirm the new queue settings and click Finish.
Add a JMS queue connection factory:
In the left pane, click Resources | JMS Providers | Default Messaging.
In the right pane, on the Default Messaging Provider page, under Connection Factories, click JMS Queue Connection Factory.
On the Default Messaging Provider | JMS Queue Connection Factory page, click New.
On the Default Messaging Provider | JMS Queue Connection Factory | New page, under Administration, enter a Name and JNDI Name. The JNDI Name must match the JMS Queue Connection Factory defined for the ALBPM engine in Process Administrator.
Under Connection, set the Bus Name to the bus previously created, and set the Target Type to the bus member previously created.
Click OK.
Add a JMS queue:
In the left pane, click Resources | JMS Resources | Default Messaging.
In the right pane, on the Default Messaging Provider page, under Destinations, click JMS Queue.
On the Default Messaging Provider | JMS Queue page, click New.
On the Default Messaging Provider | JMS Queue | New page, under Administration, enter a Name and JNDI Name. The JNDI Name must match the JMS Queue Name defined for the ALBPM engine in Process Administrator.
Under Connection, set the Bus Name to the bus previously created, and set the Queue Name to ToDoQueue.
Click OK.
Add a JMS activation specification:
In the left pane, click Resources | JMS Resources | Default Messaging.
In the right pane, on the Default Messaging Provider page, under Activation Specifications, click JMS Activation Specification.
On the Default Messaging Provider | JMS Activation Specification page, click New.
On the Default Messaging Provider | JMS Activation Specification | New page, under Administration, enter a Name and JNDI Name. The JNDI Name must match the ActivationSpecificationJNDI Name defined for the ALBPM engine in Process Administrator.
Under Connection, set the Bus Name to the bus previously created and click OK.
Add JMS a topic connection factory:
In the left pane, click Resources | JMS Resources | Default Messaging.
In the right pane, on the Default Messaging Provider page, under Connection Factories, click JMS Topic Connection Factory.
On the Default Messaging Provider | JMS Topic Connection Factory page, click New.
On the Default Messaging Provider | JMS Topic Connection Factory | New page, under Administration, enter a Name and JNDI Name. The JNDI Name must match the JMS Topic Connection Factory defined for the ALBPM engine in Process Administrator.
Under Connection, set the Bus Name to the bus previously created and click OK.
Add a JMS topic:
In the left pane, click Resources | JMS Resources | Default Messaging.
In the right pane, on the Default Messaging Provider page, under Destinations, click JMS Topic.
On the Default Messaging Provider | JMS Topic page, click New.
On the Default Messaging Provider | JMS Topic | New page, under Administration, enter a Name and JNDI Name. The JNDI Name must match the JMS Topic Name for Server News defined for the ALBPM engine in Process Administrator.
Under Connection, set the Bus Name to the bus previously created, and set the Topic Space to Default.Topic.Space.
Click OK.
On the Default Messaging Provider page, under Messages, click Save.
On the Default Messaging Provider | JMS Topic | Save page, under Messages, click Save.
Note: After adding JMS resources to WebSphere, it is necessary to stop and restart the WebSphere for the changes to take effect.