File Listener form
Completing the Process tab

Field

Description

Enter the number of seconds this listener waits before it checks for newly arrived files.

Select to prevent processing of a second or later file that has the same name as a previously processed file.

If selected, the system searches the Log-Service-File class for past instances of processing by this listener containing the current file name. If a match is found, the system:

• Bypasses normal processing of the file
• Copies the duplicate input file to the work directory
• Saves it with .dup as the file extension

Leave this check box cleared in most situations, when a system consists of a single server node or the file listener is set to run on only a single node.

Select to cause each listener thread to lock the temporary files it creates, to avoid name collisions when multiple copies of the listener may be running.

Select this check box only when required, because locking adds processing that can impact performance.

Field

Description

If selected, the listener creates a report file in the source directory using the contents of the Source Property. The name of the report file is the original file name suffixed with the target file extension. When the Source Property field contains the keyword $XML, the system writes an XML representation of the source page to the file.

Specify the name of a page to hold the report. This page has class Log-Service-File. If blank, the default page name is LogServiceFile. Properties pyOriginalDirectory and pyOriginalFileName identify the input file.

Select the property (on the page identified in the Source Page Name field) that you want to report on. Enter the keyword $XML in this field to write an XML representation of the entire page you identified in the Source Page field into the report file.

Select to cause instances of the Log-Service-File class (which record the processing of a listener) to be saved in the PegaRULES database, for reporting, debugging, or reporting.

When not selected, instances of this class present in server JVM memory only and are discarded when the server is stopped.

For optimal performance in high-volume production situations, clear this check box after you complete debugging a Service File configuration.

Field

Description

Optional. To identify an activity that runs after the processing of a file is complete, enter the Applies To key part here.

Optional. To identify an activity that runs after the processing of a file is complete, enter the Activity Name key part here.

Select Keep or Delete. After an input file is successfully processed, it can be kept or deleted. The system moves kept files to the Completed file folder.

Consider total disk space requirements if the input files are large and you select Keep.