Configuring Batch Adapter BatchLocalFile Connectivity Map Properties

Pre Directory Name

Specifies the directory name (path) on the external system in which a file is renamed or copied. This setting is only for the Rename or Copy operations of Pre Transfer Command parameter. The value can be a literal, or pattern name.

For outbound transfers, the directory is created if it does not already exist. 

Special characters are allowed. For example, the pattern %f indicates the original working directory name. The expansion of any special characters is carried out each time this parameter is used.

For path separator, use the forward slash “ / ” instead of the back slash “ \ ”. The adapter interprets the back slash as a special character. For example, use c:/temp/dir.

See the Pre Directory Name Is Pattern property.

Enter the exact name of the directory (with the path), enter a pattern name, or select one of the following values: 

• %f

• %f.%y%y%y%y%M%M%d%d.

  %h%h%m%m%s%s%S%S%S

• %f.copy

• %f.rename

Pre Directory Name Is Pattern

Specifies whether the Pre Directory Name represents a literal or a name pattern, as follows:

• Yes: Indicates that the name value you enter is assumed to be a name pattern.

• No: Indicates that the name value entered is a literal, an exact match. No pattern matching or name expansion is done.

  See the Pre Directory Name Is Pattern property.

Select Yes or No.

The configured default is No.

Pre File Name

Specifies the file name on the external system, to which a file is renamed or copied. This setting is only for the Rename or Copy operations of Pre Transfer Command parameter. The value can be a literal or pattern name.

Special characters are allowed, for example, the pattern %f indicates the original working file name. The expansion of any special characters is carried out each time this parameter is used.

See the Pre File Name Is Pattern property.

Enter the exact name of the file, enter a pattern name, or select one of the following values: 

• %f

• %f%#

• %f.%y%y%y%y%M%M%d%d.%h

  %h%m%m%s%s%S%S%S

• %f.copy

• %f.rename

Pre File Name Is Pattern

Specifies whether the Pre File Name represents a literal or a name pattern, as follows:

• Yes: Indicates that the name value you enter is assumed to be a name pattern.

• No: Indicates that the name value entered is a literal, an exact match. No pattern matching or name expansion is done.

See the Pre File Name property.

Select Yes or No.

The configured default is No.

Pre Transfer Command

Allows you to determine the action executed directly before the actual file transfer.

In the case of an inbound file transfer, you can make the file unavailable to other clients polling the target system through the same directory and file pattern or name. In the case of an outbound transfer, you can make an automatic backup of the existing file. The options are as follows: 

• Rename: Rename the target file.

• Copy: Copy the target file.

• None: Do nothing.

Select Rename, Copy, or None; the default is None.

Rename and Copy overwrite the file or directory specified by the Pre Directory Name and Pre Transfer Name parameter, if it exists.

Max Sequence Number

Use this parameter when you have set up the target file name to contain a sequence number. It tells the adapter that when this value (the Max Sequence Number) is reached, to reset the sequence number to the Starting Sequence Number value.

This parameter is used for the name pattern %#. 

See Using Name Patterns.

An integer from 1 to 2147483647. The value of Max Sequence Number must be greater than that of Starting Sequence Number.

The configured default value is 999999.

Starting Sequence Number

Use this parameter when you have set up the target file name to contain a sequence number. It tells the adapter which value to start with in the absence of a sequence number from a previous run.

Also, when the Max Sequence Number value is reached, the sequence number rolls over to the Starting Sequence Number value.

This parameter is used for the name pattern %#. 

An integer from 0 to 2147483647. The value of the Starting Sequence Number must be less than the Max Sequence Number.

The configured default value is 1.

Post Directory Name

Specifies the directory name (path) on the external system in which a file is renamed. This setting is only for the Rename operation of the Post Transfer Command parameter. The value can be a literal or pattern name.

For outbound transfers, the directory is created if it does not already exist. 

Special characters are allowed, for example, the pattern %f indicates the original working directory name. The expansion of any special characters is carried out each time this parameter is used.

For path separator, use the forward slash “ / ” instead of the back slash “ \ ”. The adapter interprets the back slash as a special character. For example, use c:/temp/dir.

See the Post Directory Name Is Pattern property.

Enter the exact name of the directory (with the path), enter a pattern name, or select one of the following values: 

• %f

• %f%#

• %f.%y%y%y%y%M%M%d%d.

  %h%h%m%m%s%s%S%S%S

• %f.copy

• %f.rename

Post Directory Name Is Pattern

Specifies whether the Post Directory Name represents a literal or a name pattern, as follows:

• Yes: Indicates that the name value you enter is assumed to be a name pattern.

• No: Indicates that the name value entered is a literal, an exact match. No pattern matching or name expansion is done.

See the Post Directory Name property.

Select Yes or No.

The configured default is No.

Post File Name

Specifies either the name of the file that the transferred file is renamed to (Rename) or the directory it is moved to (Move), depending on the setting in the parameter Post Transfer Command.

The value can be a literal or pattern name. 

Special characters are allowed. The expansion of any special characters are carried out each time this parameter is used. 

See the Post File Name Is Pattern property.

Enter the exact name of the file, enter a pattern name, or select one of the following values: 

• %f

• %f.%y%y%y%y%M%M%d%d.

  %h%h%m%m%s%s%S%S%S

• %f.copy

• %f.rename

Post File Name Is Pattern

Specifies whether the Post File Name represents a literal or a name pattern, as follows:

• Yes: Indicates that the name value you enter is assumed to be a name pattern.

• No: Indicates that the name value entered is a literal, an exact match. No pattern matching or name expansion is done.

See Post File Name property.

Select Yes or No.

The configured default is No.

Post Transfer Command

Allows you to execute a desired action directly after the actual file transfer. For an inbound transfer, you can mark the transferred file as consumed by making an automatic backup (Rename) or by destroying it permanently (Delete). For an outbound transfer, you can make the transferred file available to other clients by renaming it. The options are as follows:

• Rename: Rename the target file. Rename overwrites the file specified by the Post File Name and Post Directory Name, if it exists

• Copy: Copy the target file.

• Delete: Delete the target file (inbound transfers only).

• None: Do nothing.

Select Rename, Copy, Delete, or None.

The configured default is None.

Resume Reading Enabled

Specifies whether the OTD handles the Resume Reading feature as follows:

• Yes: Enables the OTD to store any state information necessary to resume reading from the current file in a subsequent execution of the Collaboration Rule.

• No: Indicates that the file is considered “consumed” even if the streaming consumer did not read until the end of file.

Select Yes or No

The configured default is No.

Synchronized must be set to Yes to use Resume Reading.

Synchronized

Specifically applies to legacy Batch adapter Projects. Provides backward compatibility to allow Projects that were created using the Batch adapter version 5.0.7 or earlier to be imported and deployed without a change in the adapters behavior. The selections are: 

• Yes: Provides backward compatibility for legacy (pre-5.0.8 Batch adapter) Projects. The adapter run in synchronized mode, one instance of the Collaboration after the other.

• No: For use with new Batch adapter Projects. The adapter run in parallel, creating multiple instances of the Collaboration that run in parallel.

  ---

  Note –

  All OTD instances used in a Project should have the same value for this property.

  ---

Select Yes or No.

The default setting is Yes, simulating Projects created with Batch adapter version 5.0.7 or earlier.

Synchronized must be set to Yes to use Sequence Numbering or Resume Reading.

Append

Specifies whether to overwrite or append the data to the existing file. Use this parameter for outbound file transfers only. Choose the appropriate setting as follows:

• Yes: If the target file already exists, the data is appended to the existing file.

• No: The adapter overwrites the existing file on the remote system.

  If a file with the same name does not exist, both Yes and No create a new file on the external host.

Select Yes or No

The configured default is No.

Target Directory Name

Specifies the directory name (path) on the local system from which files are retrieved or where they are sent. The value can be a literal, regular expression (source), or pattern name (destination).

For outbound transfer (destination), the directory is created if it does not already exist. 

For path separator, use the forward slash “ / ” instead of the back slash “ \ ”. The adapter interprets the back slash as a special character. For example, use c:/temp/dir.

See the Target Directory Name Is Pattern property.

The directory name. 

Target Directory Name Is Pattern

Specifies whether the Target Directory Name represents a literal, or a regular expression or name pattern, as follows:

• Yes: Indicates that the name value you enter is assumed to be a name pattern or regular expression.

• No: Indicates that the name value entered is a literal, an exact match. No pattern matching or name expansion is done.

See the Target Directory Name property.

Select Yes or No

The configured default is Yes.

Target File Name

Specifies the name of the file on the local system either to be retrieved or sent. The value can be a literal, regular expression (get), or pattern name (put).

See the Target Directory Name Is Pattern property.

A file name. 

Target File Name Is Pattern

Specifies whether the Target File Name represents a literal, or a regular expression or name pattern, as follows:

• Yes: Indicates that the name value you enter is assumed to be a name pattern or regular expression.

• No: Indicates that the name value entered is a literal, an exact match.

See the Target File Name Is Pattern property.

Select Yes or No.

The configured default is No.