Job Variable Condition Properties
The Job Variable Condition Properties window is shown when you create or edit a Job Variable Condition for a Job or Job Step.
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.
Condition
Variable to test
Select the variable this condition should check. This must be a variable that has already been defined in adTempus.
Comparison rule
Specify the comparison rule to apply. The comparison will be applied based on the type of the target variable. For example, if the variable is defined as a Date/Time variable, adTempus will treat the Compare to value as a date/time and compare the values as date/time values. If the variable type is unspecified, or the Compare to value cannot be converted to the correct type, the values will be compared as text.
Compare to
Enter the value to compare the target variable to. You can insert references to other variables here. If the target variable is configured as Date, Time, or Date/Time, use the following formats:
- Date: Use YYYY-MM-dd format ("2013-05-01")
- Time: Use HH:mm:ss format, using 24-hour time ("13:45" for 1:45 PM)
- Date/Time: Use YYYY-MM-dd HH:mm:ss ("2013-05-01 13:45:23")
Text comparisons are not case-sensitive.
Use Regular Expression
If the Variable to test is a string variable, check this option to treat the Compare To value as a Regular Expression to match against the variable value.
Related Concepts