Create a new listener port

 

+

Search Tips   |   Advanced Search

 

 

Overview

Use this task to create a new listener port for the message listener service, so that message-driven beans can be associated with the port to retrieve messages.

Although one can continue to deploy an EJB 2.0 message-driven bean against a listener port (as in WAS v5), you are recommended to deploy such beans as JCA 1.5-compliant resources and to upgrade them to be EJB 2.1 message-driven beans.

If you want to deploy an enterprise application to use EJB 2.0 message-driven beans with listener ports, use this task to create a new listener port for a message-driven bean to retrieve messages from.

To create a new listener port, use the administrative console to complete the following steps:

 

Procedure

1. Display the collection list of listener ports:

   Servers | Application Servers | application server | Messaging | Message Listener Service | Listener Ports | New

2. Click New.

3. Specify the following required properties:

   Name

   The name by which the listener port is known for administrative purposes.

   Connection factory JNDI name

   The JNDI name for the JMS connection factory to be used by the listener port; for example...

   jms/connFactory1

   Destination JNDI name

   The JNDI name for the destination to be used by the listener port; for example...

   jms/destn1

4. Change other properties for the listener port, according to your needs.

5. Click OK.

6. Save your changes to the master configuration.

7. To have the changed configuration take effect, stop then restart the application server.

If enabled, the listener port is started automatically when a message-driven bean associated with that port is installed.

---

 

Related Tasks

Configure a listener port
Start a listener port
Stop a listener port

Related reference
Listener port settings

 

---