Versions Compared

Old Version 1

changes.mady.by.user Jenni Wallin

Saved on

compared with

New Version 2

changes.mady.by.user Former user

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

You open the FTPS forwarding agent configuration dialog from a workflow configuration: you can right-click the agent icon and select Configuration..., or double-click the agent icon.

To open the FTPS collection agent configuration, click Build>New Configuration. Select Workflow from the Configurations dialog. When prompted to Select workflow type, select Batch. Click Add agent and select the Forwarding tab in the Agent Selection dialog. Select the Ftps agent. Double-click the agent icon or right-click the icon and select Edit agent, to display the Agent Configuration dialog.

Connection Tab

The FTPS forwarding agent configuration - Connection tab

See the description of the figure, The FTPS Collection Agent Configuration - Connection Tab, in FTPS Collection Agent Configuration.

Target Tab

The FTPS forwarding agent configuration - Target tab


ItemDescription

Input Type

The agent can act on two input types. Depending on which one the agent is configured to work with, the behavior will differ.

The default input type is bytearray, that is the agent expects bytearrays. If nothing else is stated the documentation refer to input of bytearray.

If the input type is MultForwardingUDR, the behavior is different. For further information about the agent's behavior with MultiForwardingUDR input, refer to 9.34.2.3 FTPS Forwarding Agent MultiForwardingUDR Input. 

Directory

Absolute pathname of the target directory on the remote host, where the forwarded files will be placed. The pathname may also be given relative to the home directory of the user's account.

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

Create Directory

Check to create the directory, or the directory structure, of the path that you specify in Directory.

Note
titleNote!

The directories are created when the workflow is executed.


Compression

Compression type of the target files. Determines if the agent will compress the files before storage or not.

  • No Compression - Agent does  not  compress the files.

  • Gzip - agent compresses the files using gzip.

    Note
    titleNote!

    No extra extension will be appended to the target filenames, even if compression is selected.



Produce Empty Files

If you require to create empty files, check this setting.

Handling of Already Existing Files

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

  • Overwrite - The old file will be overwritten and a warning will be logged in the System Log.

  • Add Suffix - If the file already exists the suffix ".1" will be added. If this file also exists the suffix ".2" will be 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 this option is selected, the agent will move 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 will be renamed.

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

Abort Handling

Select how to handle the file in case of cancelBatch or rollback, either Delete Temporary File or Leave Temporary File.

Note
titleNote!

When a workflow aborts, the file will not be removed until the next time the workflow is run.



Advanced Tab

The FTPS forwarding agent configuration - Advanced tab


ItemDescription

Command Port

The value in this field defines which port number the FTPS service will use on the remote host.

Timeout(s)

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

Passive Mode (PASV)

Must be enabled if FTPS passive mode is used for data connection.

In passive mode, the channel for data transfer between client and server is initiated by the client instead of by the server. This is useful when a firewall is situated between the client and the server.

Additional Hosts

List of additional host names or IP addresses that may be used to access the target directory for file storage. These hosts are tried, in sequence from top to bottom, if the agent fails to connect to the remote host set in theConnection tab.

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


Note
titleNote!

The names of the created files are determined by the settings in the Filename Template tab. The use and setting of private threads for an agent, enabling multi-threading within a workflow, is configured in the Thread Buffer tab. For further information, see 3.1.6 Workflow Template.


Backlog Tab

The Backlog tab contain configurations related to backlog functionality. If the backlog is not enabled, the files will be moved directly to their final destination when an end batch message is received. If the backlog however is enabled, the files will first be moved to a directory called DR_POSTPONED_MOVE_DIR and then to their final destination. Refer to the section, Retrieves, in 9.34.2.4 FTPS Forwarding Agent Transaction Behavior for further information about transaction behavior.

...