Filing Variables

This feature allows you to output the value of a variable to a local file on your system.  You can then use this file in other tasks or your own programs.  You can also insert the variable into various locations of a file, depending on certain criteria you select.  This feature can be usefull in many situations: examples include:
1) monitoring your own log files for 'errors' which occur today or within the last hour etc..
2) appending one file to another.

Variable name
Select the variable you need to monitor from the list.  For some variables like DATE, you need to manually enter the format. In version 6.x, you need to enter the variable name surrounded by $%…%$. In version 5.x, the surrounding $%…%$ was not required. By adding the $%…%$ into the format, it is now possible to set the Variable Name field as an entire line of text which includes the variable.
Examples of Variable Name Field entries:
Todays date is $%DATE::qqq-dd_hh:mm%$
my username is $%USERNAME%$
This ip address = $%IPADDRESS%$

Filepath
Enter the full filepath of the file which you want to save the variable to. This field supports dynamic variables.

Filing Options
Choose your filing criteria.  You can insert the value of the variable into various locations.  If you choose the 'Line Number' or one of the 'String containing' options, you should enter the correct 'Option Value' also.

Option Value
This should be used in conjunction with the chosen Filing Option above.

Examples:
Variable Name = $%DATE::qqq-dd_hh:mm%$
Filing Option = Insert at Line Number
Option Value = 10
This will insert the date/time at line 10 in the file
or
Variable Name = $%DATE::qqq-dd_hh:mm%$
Filing Option = Insert before first line containing
Option Value = error
This will insert the date/time before the first line in the file that contains the word 'error'

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:  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 that the program runs in.  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.  This way users can link output from their own programs to this program.