File Monitor by Shell Job

This section includes details about the File Monitor by Shell job.

Adapter Information

Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

This job uses the FILE_Mon adapter.

Triggered CI Data

Name	Value
codepage	${SOURCE.codepage:NA}
connected_os_credentials_id	${SOURCE.connected_os_credentials_id:NA}
credentialsId	${SOURCE.credentials_id}
hostId	${HOST.root_id}
ip_address	${SOURCE.application_ip}
language	${SOURCE.language:NA}
Protocol	${SOURCE.root_class}

Adapter Parameters

Name	Default Value	Description
binary_file_extensions	exe, bin, dat	This parameter defines what type of files are binary so that content is not read from those files.
discoverUnixHiddenFiles	false	This flag determines whether to discover hidden files on Unix-like systems. If true then all hidden files are discovered. This parameter is not dependent on the values assigned to the extensions parameter.
extensions	cfg, conf, txt, xml, exe, bin, dat	This parameter defines the files extensions that the discovery looks for.
folders	C:\temp,D:\temp	A list of folders from which to gather files.
recursively	false	This flag determines whether to scan folders recursively.

Troubleshooting and Limitations

This section describes troubleshooting and limitations for file discovery, when running the File Monitor by Shell job.

The File Monitor by Shell does not trigger automatically. This is because there is no trigger TQL query for this job: an automatic trigger on all destinations may cause an out-of-memory error on the Data Flow Probe. To solve this problem, add the triggered CI manually.

When running the File Monitor by Shell job, discovering files of more than 2Mb may cause an out-of-memory error.