This topic applies only to the IBM Business Automation Workflow Advanced configuration.

Deleting BPEL process instances

Edit online
Draft comment:
This topic only applies to BAW, and is located in the BAW repository. Last updated on 2025-03-13 12:15
You can use the Process Admin Console, a REST API call, or a wsadmin command to delete BPEL process instances that match specified criteria.
Important: To be able to count or delete BPEL processes, your user ID must be mapped onto the BPESystemAdministrator role. To map a user ID to the BPESystemAdministrator role, use the admin console and navigate to Applications > Application Types > WebSphere enterprise applications, then select BPEContainer_clusterName > Security role to user/group mapping, select the BPESystemAdministrator role, click Map Users..., search for the user ID, add it to the BPESystemAdministrator role, save, synchronize, and restart BPEContainer_clusterName.
Remember: If you want to specify particular process instance states, the states running, finished, and stopped correspond to the states active, completed, and failed in wsadmin and Process Inspector.

Using the Process Admin Console

  1. Click Server Admin > Workflow Admin > Health Management.
  2. Select the command Delete BPEL Processes.
  3. Specify values for the command's parameters.
  4. Click Submit.
  5. If there is an error, the error message is displayed. Otherwise you get confirmation that the command was submitted and a link that you can click to count how many instances that match the deletion criteria are still in the database. You can refresh the count to check the progress of the deletion.

Using a REST API call

Call the operations REST API DELETE https://host:port/ops/adv/bpm/processes.

Remember: For IBM® BPM on Cloud, the operations REST APIs have the following URL, https://hostname.bpm.ibmcloud.com/bpm/environment/ops/adv/bpm/processes, 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 instances that are in the states finished, terminated and failed:
    DELETE https://host:port/ops/adv/bpm/processes
  • To delete all instances that are in the states terminated and failed for the process template myTemplate which is valid from 2016-07-16T19:20:30-06:00:
    DELETE https://host:port/ops/adv/bpm/processes?states=terminated,failed
       &model=myTemplate&valid_from=2016-07-16T19:20:30-06:00
    Remember: If you need to specify a time zone that is ahead of UTC, you must encode the + symbol as %2B. For example, for the Central European Time zone +01:00, you must use %2B01:00 in your URL. Alternatively, you can specify a UTC date, for example ended_after=2016-01-01T01:00:00Z.
Important: All calls to the 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 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 workflow server and port is the port number that is used by the workflow server. For example, https://localhost:9443/ops/explorer

Using a wsadmin command

To delete BPEL process instances from the Business Process Choreographer database, see deleteCompletedProcessInstances.py administrative script.