A file listener runs at a defined frequency according to the run schedule. If you do not want to run the file listener on a pre defined schedule, you can start or stop a file listener manually.
A file listener listens to files on a defined location from the start time until the end time when you schedule a file listener run.
Consider the following file listener behavior when you start and stop a file listener manually:
•You start a file listener before a scheduled run. The file listener that is triggered manually runs and stops at the start time of the schedule run.
•You start a file listener after the end time of a schedule run. The file listener runs once and stops.
•You cannot start a file listener manually when a file listener is already running according to the run schedule.
•When the agent version is upgraded, the file listener is automatically submitted to the new agent version and the old version is stopped.
•If the agent fails, such as a temporary network disruption, the file listener is automatically submitted to the agent when the agent restarts. Events such as Arrive, Update, and Delete that were submitted when the agent failed are notified by the file listener when the agent restarts.
•You stop an existing file listener run. The file listener stops listening to files for that run. A new run starts at the time of the next schedule time unless the file listener is started manually.
•A file listener fails to start if the file listener is disabled, it is not associated to a task, or if the associated secure agent is down.
•A file listener fails to start if the number of file events such as arrive, update, or delete, exceeds the maximum event limit (10000 files).
Starting and stopping a file listener
You can start and stop a file listener from the Edit file listener component page or the Explore page using the Action menu. Perform the following steps to start or stop a file listener manually.
1In the Explore page, select one or more file listeners and click the Action menu. If you want to start all file listener, you can filter the file listener asset in the Explore page and click Select All.
The Start and Stop buttons are enabled.
If the file listener fails to start, a message with the failure details is displayed.
2Click Start.
The file listeners validate the configuration and start listening to files defined in the file listener configuration rules.
3Click Stop to stop the file listener. If you want to stop all file listener, you can filter the file listener asset in the Explore page and click Select All. If the file listener fails to stop, a message with the failure details is displayed.