Process Inspector actions

IBM BPM, V8.0.1, All platforms > Administer applications and processes in the runtime environment > Manage processes and their components > Administer processes with the Process Inspector > Work with process instances
Process Inspector actions

Process Inspector provides actions to recover failed process instances.

The following tables contain descriptions of the actions that can be initiated on process instances and activities when using the Process Inspector.
Only the task owner or member of the group that claimed the task can view and modify task data.

Bulk indicates that the action can be performed in bulk on multiple items at a time.
Process instances actions
Action Bulk Description
Delete Yes Deletes a process instance from the server.
This action is available when the process instance status is Completed, Failed, or Suspended.
Delete orphaned tokens Yes Deletes orphaned tokens from the server, allowing processing to continue.
Use this action when activities have been deleted during the migration of inflight process instances from an older snapshot to a newer snapshot, thus causing orphaned tokens. Deleting orphaned tokens does not recover the orphaned tokens, but allows the process to resume so that the remaining process tokens can proceed. An orphaned token is a pointer (token) that is associated with an activity or event that has been removed from a business process definition (BPD).
Important: To delete tokens, first configure the security policy. For instructions, see "Changing the security policy".
Force suspend Yes Stops the execution of a looping process.
Use this action when a process error causes an endless loop that is using a large percentage of central processing units (CPUs) and potentially diminishing server performance.
Resume
Yes
Starts a suspended process instance.
To perform this action, the user must be a member of the group that is specified in the PROFILE_HOME\config\cells\ cell_name\nodes\ node_name\servers\ server_name\process-server\config\system\99Local.xml configuration file. By default, this group is tw_admins.
<action type="ACTION_RESUME_INSTANCE">
<role>tw_admins</role>
</action>
Retry failed steps Yes
Resumes or restarts a failed process instance.
This action is available when a task fails.
Use this action on one or more process instances after a system problem is resolved.
For example, several process instances failed because the server could not access a database. After the database connection is restored, you can restart the failed process instances using the Retry failed steps action.
Suspend
Yes
Pauses the execution of an active process instance.
To perform this action the user must be a member of the group that is specified in the PROFILE_HOME\config\cells\ cell_name\nodes\ node_name\servers\ server_name\process-server\config\system\99Local.xml configuration file. By default, this group is tw_admins.
<action type="ACTION_SUSPEND_INSTANCE">
<role>tw_admins</role>
</action>
Terminate
Yes
Terminates the execution of an active process instance.
This action is available when the process instance status is Completed, Failed, or Suspended.
To perform this action the user must be a member of the group that is specified in the PROFILE_HOME\config\cells\ cell_name\nodes\ node_name\servers\ server_name\process-server\config\system\99Local.xml configuration file. By default, this group is tw_admins.
<action type="ACTION_ABORT_INSTANCE">
<role>tw_admins</role>
</action>
If about bulk processing

If you initiate a bulk operation that cannot be applied to all process instances within a selection, the operation is applied to as many items as possible.
For example, there are 10 process instances in a selection; seven are active and three are completed. When you terminate an action, only the seven active items are terminated (stopped). The three completed items cannot be stopped because they have already completed and are not currently running. A message confirms the number of items that were terminated.

Activity actions
Action Description
Escalate Opens a window from where you can reassign a task activity and modify the priority level.
Edit data Opens the data tree in a separate window from where you can edit input variables or run a service or script.
Fire now Initiates timers.
Retry failed step Restarts the activity from the step that failed.
Tip: Try changing the input values. Edit and save input variables, then click Retry failed steps.
Force suspend Stops an activity that is currently running in the Event Manager or a Coach interface.
Skip Passes data to the next activity, but no actions associated with the skipped activity will run. The skip action is only available when a task fails.
Important: Use this action with caution. Consider the implications for the integrity of the process before you choose to skip an activity.
If you want to skip an activity with predefined output values, edit and save private and output variables, then click Skip.

Work with process instances

Related tasks:
Viewing process instance details
Viewing activity details
Troubleshooting errors and failures in a failed process instance

Action	Bulk	Description
Delete	Yes	Deletes a process instance from the server. This action is available when the process instance status is Completed, Failed, or Suspended.
Delete orphaned tokens	Yes	Deletes orphaned tokens from the server, allowing processing to continue. Use this action when activities have been deleted during the migration of inflight process instances from an older snapshot to a newer snapshot, thus causing orphaned tokens. Deleting orphaned tokens does not recover the orphaned tokens, but allows the process to resume so that the remaining process tokens can proceed. An orphaned token is a pointer (token) that is associated with an activity or event that has been removed from a business process definition (BPD). Important: To delete tokens, first configure the security policy. For instructions, see "Changing the security policy".
Force suspend	Yes	Stops the execution of a looping process. Use this action when a process error causes an endless loop that is using a large percentage of central processing units (CPUs) and potentially diminishing server performance.
Resume	Yes	Starts a suspended process instance. To perform this action, the user must be a member of the group that is specified in the PROFILE_HOME\config\cells\ cell_name\nodes\ node_name\servers\ server_name\process-server\config\system\99Local.xml configuration file. By default, this group is tw_admins. <action type="ACTION_RESUME_INSTANCE"> <role>tw_admins</role> </action>
Retry failed steps	Yes	Resumes or restarts a failed process instance. This action is available when a task fails. Use this action on one or more process instances after a system problem is resolved. For example, several process instances failed because the server could not access a database. After the database connection is restored, you can restart the failed process instances using the Retry failed steps action.
Suspend	Yes	Pauses the execution of an active process instance. To perform this action the user must be a member of the group that is specified in the PROFILE_HOME\config\cells\ cell_name\nodes\ node_name\servers\ server_name\process-server\config\system\99Local.xml configuration file. By default, this group is tw_admins. <action type="ACTION_SUSPEND_INSTANCE"> <role>tw_admins</role> </action>
Terminate	Yes	Terminates the execution of an active process instance. This action is available when the process instance status is Completed, Failed, or Suspended. To perform this action the user must be a member of the group that is specified in the PROFILE_HOME\config\cells\ cell_name\nodes\ node_name\servers\ server_name\process-server\config\system\99Local.xml configuration file. By default, this group is tw_admins. <action type="ACTION_ABORT_INSTANCE"> <role>tw_admins</role> </action>

Action	Description
Escalate	Opens a window from where you can reassign a task activity and modify the priority level.
Edit data	Opens the data tree in a separate window from where you can edit input variables or run a service or script.
Fire now	Initiates timers.
Retry failed step	Restarts the activity from the step that failed. Tip: Try changing the input values. Edit and save input variables, then click Retry failed steps.
Force suspend	Stops an activity that is currently running in the Event Manager or a Coach interface.
Skip	Passes data to the next activity, but no actions associated with the skipped activity will run. The skip action is only available when a task fails. Important: Use this action with caution. Consider the implications for the integrity of the process before you choose to skip an activity. If you want to skip an activity with predefined output values, edit and save private and output variables, then click Skip.