Creating a topic space for publish/subscribe messaging

Use this task to create a new topic space for publish/subscribe messaging.

About this task

You need to create topic space when deploying JMS applications that use publish/subscribe messaging.

To create a topic space, you need to specify only a minimum set of required properties; you can change these and other properties after you have completed this task.

To create a topic space, use the administrative console to complete the following steps.

Procedure

  1. In the navigation pane, click Service integration > Buses.
  2. In the content pane, click the name of the bus that is to provide the publication points for the topic space.
  3. In the content pane, under Destination resources, click Destinations. This displays any existing destinations in the content pane.
  4. To create a topic space, click New in the content pane.
    1. On the Create New Destination page, select the Topic space option.
    2. Click Next.
    3. In the Identifier field, type the name that you want to give the topic space for administrative purposes.
  5. Optional: Specify the following properties for the topic space:
    Description
    An optional description of the topic space, for administrative purposes.
    Maximum reliability
    The maximum reliability of messages accepted by this destination.
    Best effort nonpersistent
    Messages are discarded when a messaging engine stops or fails. Messages may also be discarded if a connection used to send them becomes unavailable and as a result of constrained system resources.

    For non-transactional JMS message-driven beans and MessageListeners that use a JMS destination configured on the default messaging provider, best-effort nonpersistent messages are not recoverable. In this case, if a message is unlocked because the message-driven bean or MessageListener threw an exception, then the message is not redelivered or sent to the exception destination because it was deleted from the message store when it was passed to the listener. If you require higher message reliability for non-transactional JMS message-driven beans and MessageListeners, configure a different option for the Maximum reliability property of the bus destination.

    Express nonpersistent
    Messages are discarded when a messaging engine stops or fails. Messages may also be discarded if a connection used to send them becomes unavailable.
    Reliable nonpersistent
    Messages are discarded when a messaging engine stops or fails.
    Reliable persistent
    Messages may be discarded when a messaging engine fails.
    Assured persistent
    Messages are not discarded.
  6. Click Next.
  7. On the Confirm Topic space creation page, review the summary of actions.
    • To create the topic space, click Finish.
    • If you want to change any of the properties that you have specified, click Previous, then change the properties on the preceding pages.
  8. Save your changes to the master configuration.

What to do next

If you want to change properties of the topic space, see Configuring bus destination properties.

By default, messages that cannot be delivered to the topic space are sent the default exception destination for the messaging engine that is publishing the message. If you want to use a non-default exception destination for messages that cannot be delivered to this topic space, you must have already defined that exception destination. For more information about configuring exception destinations, see Configuring an exception bus destination.

If the topic space is to be used for JMS publish/subscribe messaging, specify the topic space identifier on a JMS topic as described in Configuring a JMS topic for the default messaging provider.




In this 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: Aug 30, 2013 4:53:43 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-base-dist&topic=tjo0002_
File name: tjo0002_.html