Set message listener resources for message-driven beans >

Set a listener port

Use this task to browse or change the properties of an existing listener port, which is used by message-driven beans associated with the port to retrieve messages.

To use message-driven beans with a messaging provider that does not have a JCA 1.5 resource adapter, we cannot use activation specifications and therefore configure the beans against a listener port. There are also a few scenarios in which, although you could use activation specifications, we might still choose to use listener ports.

See about when to use listener ports rather than activation specifications, see Administer activation specifications and listener ports for message-driven beans.

A listener port defines the association between a connection factory, a destination, and a deployed message-driven bean. This enables deployed message-driven beans associated with the port to retrieve messages from the destination.

See Message-driven beans - listener port components.

When you deploy an enterprise application to use message-driven beans with listener ports, we can browse or change the configuration of a listener port.


  1. Start the admin console.

  2. In the navigation pane, click Servers > Server Types > WebSphere application servers > server_name > [Communications] Messaging > Message listener service > [Additional Properties] Listener Ports

    The Message listener port collection panel is displayed.

  3. Select the name of the listener port to work with. This displays the properties of the listener port in the content pane.

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

  5. Click OK.

  6. Save the changes to the master configuration.

  7. To have a changed configuration take effect, stop then restart the appserver.

Message listener port collection
Listener port settings


Related concepts

Message-driven beans - listener port components


Related tasks

Create a new listener port
Starting a listener port
Stopping a listener port
Delete a listener port
Migrate a listener port to an activation spec for use with the WebSphere MQ messaging provider
Deploy an enterprise application to use EJB 2.0 message-driven beans with listener ports
Administer listener ports