Script Condition Properties
The Script Condition Properties window contains the settings for a Script Condition.
Property Pages
Property pages common to all Conditions
General
Name for this condition (optional)
Optionally, enter a name for this condition.
Enabled
Check this box to enable the condition, or uncheck to disable it. A disabled condition will be ignored by adTempus.
Description/Notes
Optionally, enter an extended description or notes about this condition.
Condition Wait
The options on this page determine how adTempus waits for this condition.
Condition Wait
This option determines whether adTempus will wait for the condition to be met:
- Do not wait for condition to be met. If the condition is not satisfied the first time adTempus checks it for a given instance, adTempus treats the condition as "Failed."
- Wait until the condition is met. If the condition is not satisfied, adTempus will wait until it is satisfied. The job or step will show a status of "Waiting for Condition."
- Wait up to __ minutes for the condition to be met. adTempus will wait up to the specified time limit for the condition to be satisfied. If the condition is satisfied within that time limit, job execution will continue immediately (as depending on other conditions). If the condition is not satisfied at the end of the time limit, adTempus treats the condition as "Timed Out."
Condition Polling
This option determines how often this condition should be evaluated. In most cases you will use the default polling interval (about 30 seconds). You may wish to use a longer polling interval to reduce the load on adTempus in cases where checking a condition is resource-intensive (such as a Script Condition that does a large amount of processing).
When you set a polling interval for one or more conditions on a job or step, adTempus applies the longest polling interval to all conditions.
The server-wide default interval can be set through the Advanced Server Options window.
Once satisfied, do not re-evaluate when evaluating other conditions for this instance
This option determines how this condition behaves once it is met if the job or step also has other conditions that have not been met. adTempus will keep checking each condition until it is met or times out.
If this option is checked, adTempus will not check the condition again once it has been met. If the option is not checked, adTempus will keep checking the condition each time it checks the other conditions.
Example
Suppose your job has two conditions:
- File c:\input\*.zip must exist.
- Job "Data Process" must not be running.
Both are configured to wait up to 10 minutes for the condition to be met, and the job is configured to wait until all conditions are met.
The first time it checks conditions, adTempus finds file c:\input\file1.zip, so the condition 1 is now met. Job "Data Process" is running, so condition 2 is not met. adTempus therefore must wait for condition 2 to be met, so 30 seconds later it goes to check the conditions again. During those 30 seconds, job "Data Process" has finished running (so condition 2 has now been met), but the file c:\input\file1.zip has been deleted.
If condition 1 has the Once satisfied... option checked, adTempus will not re-evaluate the condition, so it considers the condition to be satisfied even though the file no longer exists. The job is therefore triggered.
If condition 1 does not have the Once satisfied... option checked, adTempus will re-evaluate the condition and find that the file no longer exists. Condition 1 therefore is no longer satisfied, so adTempus will continue waiting until it is satisfied again, or until the wait time elapses.
Script Condition
Script to evaluate
Select or create the script that adTempus should evaluate. See the Script Overview topic for information on working with scripts.
See the Script Condition overview for guidelines on implementing a condition script.
Your script must return a value of either True (condition is satisfied) or False(condition is not satisfied). Any other value will cause the condition to fail.
Related Concepts