Configuring 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.

Before you begin

If you want to use message-driven beans with a messaging provider that does not have a JCA Version 1.5 or 1.6 resource adapter, you cannot use activation specifications and therefore you must configure your beans against a listener port. There are also a few scenarios in which, although you could use activation specifications, you might still choose to use listener ports. For example, for compatibility with existing message-driven bean applications.

About this task

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

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

Procedure

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

    The Message listener port collection panel is displayed.

  3. Select the name of the listener port that you want to work with.
    This displays the properties of the listener port in the content pane.
  4. Optional: Change properties for the listener port, according to your needs.
  5. Click OK.
  6. Save your changes to the master configuration.
  7. To have a changed configuration take effect, stop then restart the application server.