Input Type

Directory

Enter the absolute pathname of the target directory on the remote host, where the forwarded files are to be placed. You can also enter the pathname relative to the home directory of the Username account.

The files are temporarily stored in the automatically created subdirectory DR_TMP_DIR in the target directory. When an End Batch message is received, the files are moved from the subdirectory to the target directory.

Create Directory

Compression

Produce Empty Files

If you select this check box, the agent creates empty output files for empty batches rather than omitting those batches.

Handling of Already Existing Files

Select the behavior of the agent when the file already exists, the alternatives are:

• Overwrite - The old file is overwritten and a warning is logged.

• Add Suffix - If the file already exists the suffix ".1" is added. If this file also exists the suffix ".2" is tried instead and so on.

• Abort - This is the default selection and is the option used for upgraded configurations, that is workflows from an upgraded system.

Use Temporary Directory

If you select this option, the agent moves the file to a temporary directory before moving it to the target directory. After the whole file has been transferred to the target directory, and the endBatch message has been received, the temporary file is removed from the temporary directory.

Use Temporary File

If there is no write access to the target directory and, hence, a temporary directory cannot be created, the agent can move the file to a temporary file that is stored directly in the target directory. After the whole file has been transferred, and the endBatch message has been received, the temporary file is renamed.

The temporary filename is unique for every execution of the workflow. It consists of a workflow an agent ID, and a file number.

Abort Handling

Port

Enter the port number that the SCP service is to use on the remote host.

Timeout (s)

Enter the maximum time, in seconds, to wait for a response from the server. 0 (zero) means to wait forever.

Accept New Host Keys

Enable Key Re-Exchange

Use this check box to enable and disable automatic re-exchange of session keys during ongoing connections. This can be useful if you have long lived sessions as you may experience connection problems for some servers if one of the sides initiates a key re-exchange during the session.

Additional Hosts

You can add additional host names or IP-addresses that may be used to establish a connection. These hosts are tried, in sequence from top to bottom, if the agents fail to connect to the remote host set in the Connection tab.

Use the Add, Edit, Remove, Move up and Move down buttons to configure the host list.

Execute

Select between the two options:

• Before Move: Execute the following command and its arguments prior to transfer.

• After Move: Execute the following command and its arguments on the local copy of the transferred UDR, after transfer. This is the default behavior.

Command

Enter a command or a script.

Arguments

This field is optional. Each entered parameter value has to be separated from the preceding value with a space.

The temporary filename is automatically inserted as the second last parameter, and the final filename is inserted as the last parameter. This means that if, for instance, no parameter is given in the field, the arguments will be as follows:

$1=<temporary_filename>   $2=<final_filename>

If three parameters are given in the Arguments field, the arguments are set as:

 $1=<parameter_value_#1>   $2=<parameter_value_#2>   $3=<parameter_value_#3>   $4=<temporary_filename>   $5=<final_filename> 

Enable Backlog

Select this check box to enable backlog functionality. When not selected the agent's behavior is similar to the standard SFTP forwarding agent.

Directory

Enter the base directory in which the agent creates subdirectories to handle backlogged files. You can use absolute or relative path names.

Type

You can select Files or Bytes. Files is the maximum number of files permitted in the backlog folder. Bytes is the total sum (size) of the files in the backlog folder.

If a limit is exceeded, the workflow aborts.

Size

Enter the maximum number of files or bytes that the backlog folder can contain.

Processing Order

Determine the order by which the backlogged data is to be processed once connection is reestablished: you can select First In First Out (FIFO) or Last In First Out (LIFO).

Duplicate File Handling

Select the behavior that you want if a file with the same file name as the one being transferred is detected. You can select Abort or Overwrite and the action is taken both when a file is transferred to the target directory or to the backlog.