Process Trigger Properties

The Process Trigger Properties window contains the settings for a Process Trigger.

Property Pages

General

Name for this trigger (optional)

Optionally, specify a descriptive name for the trigger.

Enabled

Uncheck this box to disable the trigger. If the trigger is not enabled, adTempus will ignore it (it will not cause the job to trigger).

Minimum Interval

Specify the minimum interval (in seconds) for this trigger. Once the triggers conditions are satisfied and the job is triggered, adTempus will ignore this trigger for the specified interval.

For example, suppose you are using a File Trigger to trigger the job whenever a new file is added to a folder. If you set the interval to 60 seconds, then once adTempus triggers the job, it will ignore any new files that arrive in the next 60 seconds.

Description/Notes

Enter any extended descriptive information or notes for this trigger.

Job Variables

The Job Variables page allows you to define Job Variables that will be set for this job only when it is started by this trigger.

The Job Variable list shows variables defined for the current object as well as variables inherited from a higher level. Icons next to each variable in the list convey information about their inheritance:

The variable is inherited from a higher level
The variable is inherited from a higher level and is locked (cannot be overridden)
The variable is inherited from a higher level and has been modified at this level
The variable is new at this level
The variable is inherited from a higher level and must be overridden (a value provided) at this level
The variable has been overridden (redefined) at a lower level. This icon only appears if you have analyzed variable usage (see below).

When you hove the mouse pointer over the icon for an inherited variable, adTempus will show where the variable was inherited from.

Filtering the variable list

The variable list can be filtered to:

  • Hide inherited variables (so you only see variables defined at this level)
  • Hide variables that cannot be modified (inherited variables that are locked to prevent modification)
  • Show only variables that must be overridden

Analyzing and viewing variable usage5.0

When you click Analyze variable usage, adTempus searches for all the places where the variables are used or overridden. After this analysis is complete, new columns are added to the list to show, for each variable:

  • Whether it has been overridden (redefined) at a lower level
  • A count of how many times it is referenced (used)

Clicking Show variable usage opens a new window showing all the references and overrides for the variables. This is the same window shown by the Find Variable and Function References tool.

Analyze variable usage only finds references and overrides that are "below" the current level. For example, if you are viewing the variables for a job, this will find all references and overrides within the job, or within jobs that may receive variables from this jobs (jobs run by Responses or Job Triggers). If you are viewing a group, this will find all references and overrides within groups and jobs below the selected group. That is, the tool only lists places that might be affected by changes to the variables in the list.

This tool does not show other places where the variables might be used. For example if you are viewing job A and some of the variables are also used in job B, those uses will not be listed unless there is a link between job A and job B.

To find all references to a variable:

  • If the variable is defined at the server level, use the Analyze variable usage tool from the variables list at the server level. This will show all uses everywhere in adTempus.
  • Use the Find Variable and Function References tool to find a specific variable or all variables.

Process Criteria

Processes

Specify the process names that adTempus should monitor. You must specify the executable name (e.g., "notepad.exe"). If there is more than one process on the computer with the same name, you may optionally include the full path of the version of the process that you want to monitor.

If you specify more than one process, adTempus will trigger the job whenever any of the processes you list satisfies the other criteria.

If you do not specify any processes, adTempus will trigger for every process on the system, which is probably not what you want.

Trigger Conditions

Select the conditions under which the job will be triggered. You must select at least one option.

Use a script to select processes

adTempus will run the script you specify. Information about the process will be passed to the script using the Parameters object and through Job Variables (see list below). Your script then evaluates the process information and returns True if adTempus should trigger the job, or False if it should not.

adTempus calls the script only for events that have satisfied all of the other criteria for the trigger.

Description/Notes

Enter any extended descriptive information or notes for this trigger. There is no limit on the length of the text.

Job Variables

The Process Trigger sets the following Job Variables, which can be used by a selection script or by other scripts or notification messages in the job.

Parameter Name Description
ProcessTrigger.ProcessID The Windows process ID for the process.
ProcessTrigger.ProcessName The name of the process
ProcessTrigger.ProcessEvent The action that caused the trigger: TriggerProcessStarted, TriggerProcessEnded, TriggerProcessMemExceeds.
ProcessTrigger.ProcessEventDescription Description of the action that caused the trigger: "started", "ended", or "exceeded memory threshold"

Related Concepts

Process Trigger