+

Search Tips   |   Advanced Search


Deploying an enterprise application to use EJB 2.0 message-driven beans with listener ports >

 

Create a new listener port

 

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.

 

Overview

Although you 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.

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:

    1. In the navigation pane, select Servers > Application Servers.

    2. In the content pane, click the name of the appserver.

    3. Under Communications, click Messaging > Message Listener Service.

    4. Click Listener Ports.

  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. Optional: 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 appserver.

 

Results

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
Stopping a listener port
Configure message listener resources for message-driven beansAdministering listener ports

 

Related Reference

Listener port settings