Process Termination Task Properties
The Process Termination Task Properties window is shown when you edit a Job Step that executes a Process Termination Task.
Property Pages
Property pages common to all Tasks
General
Name for this step (optional)
Optionally, specify a descriptive name for the step.
Enable this step
Uncheck this box to disable the step. If the step is not enabled, it will be skipped at execution.
Description/Notes
Enter any extended descriptive information or notes for this step.
Conditions
The Conditions page defines conditions that must be satisfied before the step is run.
Condition Criteria
The Condition Criteria determine how the conditions should be evaluated:
- Execute only if all conditions are met. The step is only executed if all of the listed conditions are met.
- Execute if any condition is met. The step is executed if any of the listed conditions is met.
If Conditions are not satisfied
The satisfaction options determine what adTempus should do if the conditions are not satisfied:
- Fail the step. The step is not executed; the status is set to Failed.
- Execute anyway. The step is executed anyway.
- Skip the step (do not report as a failure). The step is not run, but it is not treated as a failure. The status of the step is reported as "Skipped (conditions not met)."
Conditions List
The Conditions list lists the conditions that have been defined for the step. You can add, edit, or delete conditions. See the Conditions topic for information on the available condition types.
Variables
The Variables page allows you to define Job Variables for this step. You can add new Variables, or override the values of Variables inherited from the Job. Any Variables you define or override here affect only this step of the Job.
To set Variables that apply to the entire job, use the Variables page in the Job properties.
Responses
The Responses page defines the actions that adTempus should take in response to events that are fired during execution of the step. You can add, edit, delete, or reorder responses.
All job steps support the events listed below. Some tasks may define additional events .
| Event | Description |
| Step Started | Occurs at the beginning of the step. |
| Step Ended | Occurs at the end of the step, regardless of the step result. |
| Step Failed | Occurs if the step fails for any reason. |
| Step Restarted | Occurs if the step is restarted due to a Response. |
| Restart Limit Exceeded | Occurs if the restart limit is exceeded. |
| Step skipped | Occurs when the step is skipped, either because conditions were not met (if the Skip... option is selected on the Conditions page) or due to a skip option specific to the task. |
| One or more conditions failed | Occurs if one or more Conditions for the step is not satisfied. |
 Conditions not met within the specified time |
Occurs if the job or a step within the job has been waiting for conditions for longer than the specified time. |
In addition to the standard response events, this task defines the following events:
| Event | Description |
| No processes found to terminate | Occurs if no matching processes were running. |
| One or more proccess(es) could not be terminated | Occurs if one or more instance of the process could not be terminated. |
| One or more process(es) terminated | Occurs if one or more instance of the specified process was terminated. |
Process Termination
Process to terminate
Specify the executable file name of the process that adTempus should terminate. You must specify the executable name (e.g., "notepad.exe"). If there is more than one program on the computer with the same executable file name, you may optionally include the full path of the version of the process that you want to monitor.
Note that this must be an executable (.exe). The task cannot target batch files (.bat, .cmd), scripts (.vbs, .js), etc.
If more than one instance of the process is running, all instances will be terminated.
Also terminate any child processes of the target
process
Check this option to also terminate any processes that the target process has launched.
Job Variables
The Process Termination Task sets the following Job Variables, which can be used by subsequent operations in the job:
| Variable | Description |
| ProcessTermination.KilledProcessCount | The number of processes matching the target process name that were successfully terminated. |
| ProcessTermination.FailedToKillProcessCount | The number of processes matching the target process name that were not successfully terminated. |
| ProcessTermination.KilledChildProcessCount | The number of processes terminated that were child processes of target processes. |
| ProcessTermination.FailedToKillChildProcessCount | The number of processes not terminated that were child processes of target processes. |
| ProcessTermination.KilledChildProcesses | Comma-separated list of the names of the child processes that were terminated. |
| ProcessTermination.FailedToKillChildProcesses | Comma-separated list of the names of the child processes that could not be terminated. |
Related Concepts