Stopping a listener port

Use this task to stop a listener port on an application server, to prevent the listeners for message-driven beans associated with the port from retrieving messages.

About this task

A listener port defines the association between a connection factory, a destination, and a deployed message-driven bean. For more information, see Message-driven beans - listener port components.

If a message-driven bean fails to process a message several times, the listener port is automatically stopped by the application server. You can also stop a listener port manually. When a listener port is stopped, the listener manager stops the listeners for all message-driven beans associated with the port. Consequently, the associated message-driven beans can no longer process messages.

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 check box for the listener port that you want to stop.
  4. Click Stop.
  5. Save your changes to the master configuration.
  6. To have the changed configuration take effect, stop then restart the application server.