processing-rename-pattern

This command specifies the rename pattern for the NFS poller handler when a file might be processed.

Syntax

processing-rename-pattern pattern

Parameters

pattern: Specifies a PCRE that defines the rename pattern.

Guidelines

The processing-rename-pattern command specifies the PCRE to rename a file that is being processed. This function allows more than one poller to poll the same directory with the same match pattern. No lack of atomicity exists when the rename operation on the server is atomic. The poller that succeeds in renaming the input file proceeds to process the file. Any other poller that tries to rename the file at the same time fails to rename the file and proceeds to try the next file that matches the specified pattern.

To ensure uniqueness, the resulting file name is in the following format.

file.host.serial.domain.poller.timestamp

Where

file: Specifies the file name for the renamed input file.
host: Specifies the system identifier of the DataPower® Gateway as defined in system settings.
serial: Specifies the serial number of the DataPower Gateway as reported in system settings.
domain: Specifies the domain that defines the poller.
poller: Specifies the name of the poller.
timestamp: Specifies the time stamp.

Note: File-renaming cannot be used with a server that supports only 8.3 file names.

For example, if the input files are NNNNNN.input and you want to rename them to NNNNNN.processing, the match-pattern would be ([0-9] {6{})\.input$ and the rename pattern would be $1.processing. The resultant file name on the server would be as follows.

NNNNNN.processing.host.serial.domain.poller.timestamp

Note: If no processing rename pattern is configured, the file is still renamed. The only difference is that the file name portion of the resulting file is the name of the original input file, not the renamed input file.