This topic applies only to the IBM Business Process Manager Advanced configuration.

Querying and replaying failed messages, using the administrative console

Check for and replay any messages for BPEL processes or human tasks that could not be processed.

About this task

When a problem occurs while processing a message, it is moved to the retention queue or hold queue. This task describes how to determine whether any failed messages exist, and to send those messages to the internal queue again.

Procedure

  1. For the Business Flow Manager, the most flexible way to check and reply and messages on the hold queue, is to use the administrative console page for the failed event manager.
    1. Click Servers > Deployment Environments > deployment_environment_name > Failed Event Manager > Search failed events, for Event type, select BFM hold then click OK.
    2. If the search results contains any messages, you can select any of them then either click Resubmit to replay the messages, or Delete to delete them from the hold queue without replaying them.
  2. To check how many messages are in the hold and retention queues, and replay them using the Business Process Choreographer administrative console pages:
    1. Click Servers > Clusters > WebSphere application server clusters > cluster_name, then on the Configuration tab, in the Business Process Manager section, expand Business Process Choreographer.
    2. Choose one of the following options:
      • For BPEL processes, click Business Flow Manager.
      • For human tasks, click Human Task Manager.
      The number of messages in the hold queue and retention queue are displayed on the Runtime tab under General Properties.
    3. If either the hold queue or the retention queue contains messages, you can move the messages to the internal work queue.

      Click one of the following options:

      • For BPEL processes: Replay Hold Queue or Replay Retention Queue
      • For human tasks: Replay Hold Queue
      Important: The replay buttons are only visible to users who have administrator or operator authority.

Results

Business Process Choreographer tries to service all replayed messages again.