Managing message listener resources for message-driven beans

Manage the resources used by the message listener service to support message-driven beans, typically for use with a messaging provider that does not have a Java EE Connector Architecture (JCA) 1.5 resource adapter.

Before you begin

For WebSphere® Application Server Version 7 and later, listener ports are stabilized. For more information, read the article on stabilized features. You should plan to migrate your WebSphere MQ message-driven bean deployment configurations from using listener ports to using activation specifications. However, you should not begin this migration until you are sure the application does not have to work on application servers earlier than WebSphere Application Server Version 7. For example, if you have an application server cluster with some members at Version 6.1 and some at Version 7, you should not migrate applications on that cluster to use activation specifications until after you migrate all the application servers in the cluster to Version 7. Also, when you migrate to activation specifications on the z/OS® platform, you must enable the Control Region Adjunct (CRA) process of the application server (by using either the WebSphere MQ CRA settings panel or the manageWMQ command to include starting the CRA process as part of starting an application server).

If you want to use message-driven beans with a messaging provider that does not have a JCA 1.5 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.

[Fix Pack 5 or later] If you have existing message-driven beans that use the WebSphere MQ messaging provider (or a compliant third-party JMS provider) with listener ports, and instead you want to use EJB 3 message-driven beans with listener ports, these new beans can continue to use the same messaging provider.

For more information about when to use listener ports rather than activation specifications, see Message-driven beans, activation specifications, and listener ports.

About this task

The message listener service is an extension to the JMS functions of the JMS provider and provides a listener manager, which controls and monitors one or more JMS listeners. Each listener monitors either a JMS queue destination (for point-to-point messaging) or a JMS topic destination (for publish/subscribe messaging). A listener port defines the association between a connection factory, a destination, and a deployed message-driven bean. When you deploy a message-driven bean, you associate the bean with a listener port. When a message arrives on the destination, the listener passes the message to a new instance of a message-driven bean for processing. For more information, see Message-driven beans - listener port components.

Procedure

  1. Configure the message listener service.
    Note: Before configuring message listener resources, consider the message listener service implementation on the z/OS platform, which affects how you should configure your listener port. For more information, see [z/OS] Message listener service on z/OS.
  2. Administer listener ports.
    You can complete any of the following administrative tasks:
    • Create or configure a listener port.
    • Start or stop a listener port.
    • Delete a listener port.
  3. [z/OS] If the message-driven bean uses a queue hosted by WebSphere MQ as a JMS provider, optimize performance by configuring the queue destination properties to best fit your message-driven bean.

    For more information about performance, see [z/OS] Performance for WebSphere MQ queues.

  4. Configure security for message-driven beans that use listener ports.

Results

You have configured the resources needed by the message listener service to support message-driven beans.



In this information ...


Related information

IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Jun 11, 2013 8:40:09 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v701sca&product=was-nd-mp&topic=tmb_admin
File name: tmb_admin.html