+

Search Tips   |   Advanced Search


Set message listener resources for message-driven beans >

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.

A listener port defines the association between...

To use MDBs 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 MDBs.

This enables deployed MDBs associated with the port to retrieve messages from the destination.

See Message-driven beans - listener port components.

 

  1. Start the admin console and go to...

    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.

  2. Click New and 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.

  3. Change other properties for the listener port, according to the needs.

  4. Click OK.

  5. Save the changes to the master configuration.

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

 

Results

If configured as enabled, the listener port is started automatically when a MDB associated with that port is installed.

 

Related concepts

Message-driven beans - listener port components

 

Related tasks

Set a listener port
Start a listener port
Stop a listener port
Delete a listener port
Deploy an enterprise application to use EJB 2.0 MDBs with listener ports
Administer listener ports

 

Related

Listener port settings