Configuring exception destination processing for a bus destination

You can configure the exception destination processing for a queue destination or topic space destination. You can configure whether any undeliverable messages are rerouted to an exception destination, and whether to use a system default exception destination or configure a specific exception destination.

Before you begin

To configure a specific exception destination for a queue destination or topic space destination, the exception destination must exist. An exception destination must be a queue destination. See Creating a queue for point-to-point messaging.

About this task

An exception destination for a queue destination or topic space destination is the destination for a message when a message cannot be delivered because the number of delivery attempts to a transactional consumer is exceeded.

You can configure an exception destination for a bus destination as one of the following:
  • None. The bus destination does not use an exception destination and undeliverable messages are not rerouted to an exception destination. Attempts to redeliver the message continue, up to the maximum failed deliveries limit set for the bus destination. Then attempts to redeliver the message continue with a time interval between retry attempts. This interval is either the Default blocked destination retry interval of the messaging engine that is associated with this destination, or the Blocked retry timeout in milliseconds that is set for this destination.
  • System. The bus destination uses the default exception destination. Messages that cannot be delivered to the bus destination are rerouted to the system default exception destination for the messaging engine that detects the problem: _SYSTEM.Exception.Destination.messaging_engine_name. This option is the default option.
  • Specify. The bus destination uses the specified exception destination. If the bus destination cannot use this exception destination, it uses the system exception destination.
Note:
  • You cannot configure exception destination processing for a bus; you must configure exception destination processing for each destination on the bus.
  • Do not modify or delete the default system exception destination.
  • If you use an exception destination for a bus destination, it can affect message ordering in the bus.
  • Best-effort messages are always discarded if they cannot be delivered to their target destination, that is, they never use an exception destination.
  • Any report options that are set in the properties of a message also affect exception destination processing. Depending on the report options, a message might be discarded if it is not delivered.

To configure the exception destination processing for a bus destination, use the administrative console to complete the following steps.

Procedure

  1. In the navigation pane of the administrative console, click Service integration -> Buses to display a list of buses.
  2. Select the bus with the destination for which you want to configure an exception destination.
  3. In the Configuration tab, under Destination resources, click Destinations to display a list of destinations for this bus.
  4. Select the name of the bus destination you require from the list.
    The details of that destination are displayed.
  5. In the Configuration tab, under General properties, in the Exception destination section, use the radio buttons to configure the exception destination processing that this bus destination uses:
    • Select None to specify that the bus destination does not use an exception destination.
    • Select System to use the default exception destination.
    • Select Specify and enter an exception destination to configure the exception destination you require.
  6. Optional: If you selected None, you can set the time interval to apply between retry attempts, after the maximum failed deliveries limit is reached, for this destination. Select Override messaging engine blocked retry timeout default, then enter the value you require in Blocked retry timeout in milliseconds.
    Otherwise, the value set for the Default blocked destination retry interval of the associated messaging engine is used.
  7. Optional: To change the number of delivery attempts for a message, enter a value in Maximum failed deliveries per message.
    When the exception destination is configured as None, this is the number of delivery attempts before a time interval between retry attempts is applied. When the exception destination is configured as System or Specify, this is the number of delivery attempts for a message that is backed out and tried again before the message is sent to the exception destination.
  8. Optional: Select Keep count of failed deliveries per message to persist the failed delivery counts of JMS messages in the message store. This option retains the count of failed deliveries even after the system is restarted.
  9. Save your changes to the master configuration.

Results

You have configured the exception destination processing for a bus destination.

What to do next

You can also configure exception destination processing for a service integration bus link or WebSphere® MQ link.