Variable Monitor
The Variable Monitor task is a special type of task which can be used in two ways:
1) If a variable criteria is met in this task, you can run another task.
2) The Variable Monitor task can also be embedded within a Chain task, and is
useful for conditional task processing. If you want to use this task in a chain
for conditional processing, select 'None' as the 'Task To Run'. If the
criteria is satisfied, then the exit code = -100. Otherwise, the exit code = 0.
Variable name
Select the variable you need to monitor from the list. For some variables like DATE, you need to manually enter the format.
Variable value
Enter the value of the variable you want to monitor. This value will be dependent on the comparison criteria you select.
Comparison criteria
Choose your comparison criteria. This will dictate how the actual value of the system variable is compared to the variable value you entered.
For Integer comparisons, use: =, !=, , < . The values found will be converted to integers and compared
For String comparisons, use: equals, contains, starts with, ends with
For Date comparisons, use: Older than or Newer than. For Date comparisons, the Variable Value should specify both the value and the field type (m=minutes, h=hours, d=days). Date comparison examples:
For '5 days' use: 5 d
For '3 hours' use: 3 h
For '30 minutes' use: 30 m
Task To Run
Select the desired task to run, if any of the selected criteria are met. If you want to use this task in a chain for conditional processing, select 'None'. You can also select multiple tasks to run in sequence or
to run simultaneously. To run tasks in sequence, use taskTitle1|taskTitle2|taskTitle3. To run tasks simultaneously, use taskTitle1&taskTitle2&taskTitle3.
There are 4 types of variables listed:
Task Variables: Task variables values are generated/updated when the tasks run. Example: Tasks exit codes are stored as the following variable: TaskTitle::ExitCode
System Variables: Program system variables which are resolved when the current task runs, examples are DATE, USERNAME etc..
Java Variables: Java variables, which are available to the Java Virtual Machine. You can get the value of java variables from the Utilities menu
/ Java Variables
User Variables: Users can add their own variables via batch files, scripts or programs. Users can link output from their own programs to this program.