Previous Topic: Monitor File OperatorNext Topic: Output Parameters


Input Parameters

File/directory name

Specifies the full path for a file or directory to watch. The location must be accessible to the File Management operators on the touchpoint where they are running at run time.

If you specify a file or directory without specifying the full path, the File Management operators use the CA Process Automation Bin directory as the relative path for the specified file or directory. Typically, you can use the slash mark (/) character in a path.

State timer (secs)

Specifies the minimum delay in seconds during which the specified condition must continuously hold before CA Process Automation executes branches for the Completed state.

Condition

Specifies the condition to execute branches for the Completed state:

Minimum file size

If "Presence" is specified for Condition, this option specifies the minimum file size in bytes for this operator to execute branches for the Completed condition.

Pattern

If Pattern matching is specified for Condition, this option specifies a regular expression that returns the pattern searched for by the operator (see Using Masks to Specify Patterns in Strings in the Content Designer Guide).

To match any number of multiple lines, you can use the \n escape in the Pattern field. The following example matches lines starting with “Log”, followed by any number of intervening new lines and a string of text ending in “Error=89”:

"Log.*\n.*Error=89"

If you are accustomed to using escape characters in programming languages, this \n escape matches any number of new lines on either Windows or UNIX. This escape does not match a single-line feed character.

Separator

Specifies the character that delimits the zone in Pattern to save to the variables that Variable names specify.

Start from end of file

Starts searching from the end of a specified file to find the last occurrence of a pattern in a file. This option lets you match the newest messages in a file.

Case sensitive pattern matching

Considers upper-case and lower-case characters when searching for a pattern. If you do not select this check box, the letters in a pattern match both upper and lower-case characters.

File Search Offset

Specifies a starting position for a search.

To perform a looped pattern match, you can use the MatchPos and MatchEntry variables from the operator dataset

 

to start where the previous match left off:

Process.Operator_name. MatchedPos+ Len(Process.Operator_name.MatchedEntry)
Variable names

Specifies the variable names in which to save text that matches the delimited zones in the pattern. Operator dataset variables are accessed through the process dataset, using the keyword Process. For example, specifying the variable names Level and Code would assign extracted substring values to the operator dataset variables Process.Operator_name.Level and Process.Operator_name.Code. You can add, remove, and order the variables that are used to store matched strings using the toolbar.