Configure the message listener service

The message listener service provides JMS message listeners that are used by message driven beans (MDBs). These listeners are associated with a queue connection factory and a queue or with a topic connection factory a topic, depending on the JMS messaging model that the listener uses. You must configure the message listener service before you install MDB application components.

For help with the message listener service and listener port settings, see these topics:

• Message listener service
• Listener port settings

These sections describe how to administer the message listener service:

• Configure listener ports
• Modify listener ports
• Remove listener ports
• Start listener ports
• Stop listener ports

Configure listener ports

To configure a new listener port, follow these steps:

1. Start the administrative console.
2. In the topology tree, expand Servers and click Application Servers.
3. On the Application Servers page, click the name of the application server for which you want to configure a listener port.
4. On the application server's detail page, click Message Listener Service --> Listener Ports.
5. On the Listener Ports page, click New.
6. Specify a name, initial state, connection factory JNDI name, and destination JNDI name for the listener port. You can also specify optional properties on this page.
7. Click OK.
8. Save the configuration.

Modify listener ports

To modify a listener port, follow these steps:

1. Start the administrative console.
2. In the topology tree, expand Servers and click Application Servers.
3. On the Application Servers page, click the name of the application server for which you want to modify a listener port.
4. On the application server's detail page, click Message Listener Service --> Listener Ports.
5. On the Listener Ports page, click the name of the listener port that you want to modify.
6. Make your changes.
7. Click OK.
8. Save the configuration.

Remove listener ports

To remove a listener port, follow these steps:

1. Start the administrative console.
2. In the topology tree, expand Servers and click Application Servers.
3. On the Application Servers page, click the name of the application server for which you want to remove a listener port.
4. On the application server's detail page, click Message Listener Service --> Listener Ports.
5. On the Listener Ports page, select the checkbox for the listener port that you want to remove.
6. Click Delete.
7. Save the configuration.

Start listener ports

When you start a listener port is started, the listener manager tries to start the listener for each MDB associated with the port.

• If an MDB is running, the listener manager starts the listener port and the listener for the MDB.
• If an MDB is not running, the listener manager starts the listener port, but does not start the listener for the MDB.
• If you start an MDB after starting the associated listener port, the listener for the MDB is also started.

After you start a listener port, the listeners for message driven beans associated with the port can retrieve messages. To start a listener port, follow these steps:

1. Start the administrative console.
2. In the topology tree, expand Servers and click Application Servers.
3. On the Application Servers page, click the name of the application server for which you want to start a listener port.
4. On the application server's detail page, click Message Listener Service --> Listener Ports.
5. On the Listener Ports page, select the checkbox for the listener port that you want to start.
6. Click Start.

Stop listener ports

To stop a listener port, follow these steps:

1. Start the administrative console.
2. In the topology tree, expand Servers and click Application Servers.
3. On the Application Servers page, click the name of the application server for which you want to stop a listener port.
4. On the application server's detail page, click Message Listener Service --> Listener Ports.
5. On the Listener Ports page, select the checkbox for the listener port that you want to stop.
6. Click Stop.