Deleting on-hold Event Manager tasks

Edit online

To delete Event Manager tasks that are on hold, you can use the health management capability of the Process Admin Console, or a REST API call via the Swagger interface, or a wsadmin command.

Note: Do not use stored procedures to delete tasks or instances. It might corrupt the data for on-hold Event Manager tasks.
Important: If you delete a task that belongs to an active instance, there is the danger that the instance will become corrupted and require fixing by either skipping or moving the navigation token. Generally, on-hold Event Manager tasks that triggered UCAs are safer to delete than other on-hold Event Manager tasks.

Using the Process Admin Console

  1. Click Server Admin > IBM BPM Admin > Health Management.
  2. Select the command Delete Event Manager tasks.
  3. Either specify to delete all tasks or a list of IDs of tasks to delete.
  4. Click Submit.
  5. If there is an error, you will see the error message.
  6. If there is no error, you see the results of the deletion.

Using a REST API call

Call the BPM operations REST API DELETE https://host:port/ops/std/bpm/event_manager_tasks.

Remember: For IBM® BPM on Cloud, the operations REST APIs have the following URL, https://hostname.bpm.ibmcloud.com/bpm/environment/ops/std/bpm/event_manager_tasks, where environment has the value dev for the development system, test for the test system, or run for the production (runtime) system.
The following examples illustrate how to use the API.
  • To delete all on-hold Event Manager tasks:
    DELETE https://host:port/ops/std/bpm/event_manager_tasks?all=true
  • To delete specific on-hold Event Manager tasks :
    DELETE https://host:port/ops/std/bpm/event_manager_tasks?em_task_ids=9,8,7
Important: All calls to the Business Automation Workflow operations REST API require that the HTTP header BPMCSRFToken is set with every request. For information about how to obtain a token, see Preventing cross site request forgery.
Tip: For more details about the BPM operations REST APIs and to try invoking them from a browser, use the Swagger interface. The Swagger interface is available at the URL https://server:port/ops/explorer Where server is the host name of your BPM server and port is the port number that is used by the BPM server. For example, https://localhost:9443/ops/explorer

Using a wsadmin command

To delete on-hold Event Manager tasks, see BPMDeleteOnHoldEMTasks command.