IBM BPM, V8.0.1, All platforms > Administer applications and processes in the runtime environment > Manage processes and their components > Administer BPEL processes and human tasks > Manage the lifecycle of BPEL processes

Delete BPEL process instances using Business Process Choreographer Explorer

Process templates can be modeled so that process instances are not automatically deleted when they complete. You can explicitly delete these process instances after they complete.

To delete a process instance, you must be a process administrator or system administrator. However, if Business Flow Manager is using the alternative process administration mode that restricts process administration to system administrators, then only users in the BPESystemAdministrator role can perform this action.

The process instance must be in the finished, failed, terminated, or compensated state.

Completed processes instances are automatically deleted from the Business Process Choreographer database if the corresponding property is set for the process template in the process model.

You might want to keep process instances in your database, for example, to query data from process instances that are not written to the audit log, or if you want to defer the deletion of processes to off-peak times. However, old process instance data that is no longer needed can impact disk space and performance. Therefore, you should regularly delete or archive process instance data that you no longer need or want to maintain. Verify that you run this maintenance task at off-peak times.

You can delete completed process instances using either Business Process Choreographer Explorer, for example, to delete individual process instances, or the deleteCompletedProcessInstances administrative script to delete several process instances at once. Alternatively, you can archive completed process instances in the Business Process Archive database.

In Business Process Choreographer Explorer to delete a process instance.


Procedure

  1. Display the process instances that you administer.

    Click Administered By Me under Process Instances in the Views tab navigation pane.

  2. Select the process instance that you want to delete and click Delete.


Results

This action deletes the selected process instance from the database.

Manage the lifecycle of BPEL processes using Business Process Choreographer Explorer


Related concepts:
Lifecycle of BPEL processes
Alternative administration modes for BPEL processes


Related tasks:
Delete completed process instances
Archiving completed process and task instances