Modify an FTP (embedded) pickup or delivery

After you create an FTP (embedded) pickup or delivery, you can view and modify the fields that define the object.

This topic provides information for completing fields in the maintenance pages.

For related information, see the following topics:

• Lockout settings for FTP (embedded) server users

FTP (embedded) settings tab (pickup)

• Embedded FTP server – The name of the server. A link is provided to view the settings for the embedded server. You also can change servers.
• View settings for this application – Click this link to open the Modify Application Pickup screen for this exchange. For a description of the fields you can view when you click this link, see FTP (embedded) transport configuration.
• Host – The name used by Activator for the computer running the embedded server. You cannot change this field.
• Host used by partners – This is the fully qualified domain name or IP address your partners use to send messages to this delivery exchange. When you export your community profile as a partner profile, the host information becomes part of your exported partner profile.
• You can change this field by clicking View settings for this embedded server and changing the External host or IP address field. If your network uses a load balancer or firewall, contact your network administrator for the correct value. Any change to this field affects all delivery exchanges that reference the server.

FTP (embedded) settings tab (delivery)

• Embedded FTP server – The name of the server. A link is provided to view the settings for the embedded server. You also can change servers.
• Host – The name used by Activator for the computer running the embedded server. You cannot change this field.
• Host used by partners – This is the fully qualified domain name or IP address your partners use to send messages to this delivery exchange. When you export your community profile as a partner profile, the host information becomes part of your exported partner profile.
• You can change this field by clicking View settings for this embedded server and changing the External host or IP address field. If your network uses a load balancer or firewall, contact your network administrator for the correct value. Any change to this field affects all delivery exchanges that reference the server.

Directories tab (pickup and delivery)

• FTP user – The name of the user.
• Directory path – The FTP directory associated with the user. A specific combination of user and directory can be associated with only one exchange.
• Specify what to do when the back-end system uploads messages to subdirectories of the directories listed above (pickup only)– Select an option:
  • Allow – Enables the user to write files to any subdirectory under the root path.
  • Do not allow – Enables the writing of files to a subdirectory under the root path only when a message attribute is set up for each subdirectory level.

Filenames tab (delivery)

Delivery file name definition

• Preserve original filenames – (default) Select this option if you want the original file names to be preserved when Activator delivers messages.
• Preserving original file names enables your back-end application to process binary messages based on their file names.
• Generate unique filenames – Select this option to have the system provide a unique file name (instead of using the original name).
  • Automatically generate unique filenames – Activator appends to the file name a hex representation of a monotonically increasing file name counter that is maintained in the database. Names are guaranteed to be unique. In addition, if the original file name had an extension, the same extension is appended to the unique name the system generates.
  • Example with the original file extension:
  • dabeed45_4cb.edi
  • Example without the original file extension:
  • z47e4120_4ce
  • Define custom filename construction – Activator generates a file name using a pattern that you specify. Enter the pattern in the Pattern field.
  • For additional information about entering renaming patterns, see File renaming patterns.

Duplicate file name handling

• Overwrite duplicate filenames – If Activator detects a duplicate file name, it overwrites the existing file, replacing it with the duplicate file.
• Sequentially number duplicate filenames – (default) When you select this option you must also select a name generation option:
  • Automatically generate unique filenames – (default). If Activator detects a duplicate file name, it generates a sequentially numbered file name. Activator appends a number to the new file in the format: filename_c4
  • Define custom filename construction – Activator generates a file name using a pattern that you specify. Enter the pattern in the Pattern field.
  • For additional information about entering renaming patterns, see File renaming patterns.
• Append to existing files – Append the duplicate file content to the content of the original file.

Advanced tab (pickup)

• Allow FTP clients to add, remove subdirectories – Enable subdirectory management on the client side.
• Back up the files that go through this transport – Indicates whether the system backs up copies of the messages it retrieves from integration or receives from partners.
• Backing up files is strongly recommended. This is required for the system to perform fail-over operations such as attempting to send messages again (retries) in case of a transport connection failure. Without backups, a message in process cannot be recovered if the server stops or restarts. Backups also are needed if you want the ability to resubmit messages to a back-end application or resend messages to partners. Backup files are stored in \<install directory>\common\data\backup, unless you specify otherwise.
• Process consumed messages using community collaboration settings – Apply the community collaboration settings to the messages that are consumed by this pickup.
• Perform content processing on consumed messages – Select this option if you want to apply processing to the messages you consume using this exchange. If you select this option you can then select a service to supply the processing.
• Restrict maximum file size for this transport – Optionally lets you specify the maximum size of files a transport can handle.
• If Activator receives a file larger than the maximum, the file is rejected and a message is written to the events log.
• Express the maximum size in bytes. Do not use commas. For example, a kilobyte is 1024 bytes, a megabyte is 1048576 bytes, a gigabyte is 1073741824 bytes. The smallest maximum allowed is 1000 bytes. On the opposite extreme, you can enter the largest number the field can accommodate.

Advanced tab (delivery)

• Maximum concurrent connections – (For partner trading delivery only.) The number of total open connections Activator can make to a partner.
• The default value is suitable in almost all cases. However, if a partner says Activator is over running his receiving system, decrease the value. (This advice does not apply to OFTP X.25 or X.25 over ISDN, as the default maximum value is 1 for those transports.)If sending messages to Transfer CFT via Transfer CFT (PeSIT), the value in this field must be less than the CFTTCP setting in Transfer CFT.
• Retries – (For partner trading delivery only.) The number of times Activator retries to connect to the partner’s transport if the initial attempt to connect and send the message failed.
• Delete file after it is downloaded – Select this if you want the embedded server to delete files after they have been downloaded from it.
• Allow FTP clients to add, remove subdirectories – Enable subdirectory management on the client side.
• Back up the files that go through this transport – Indicates whether the system backs up copies of the messages it retrieves from applications or receives from partners.
• Backing up files is strongly recommended. This is required for the system to perform fail-over operations such as attempting to send messages again (retries) in case of a transport connection failure. Without backups, a message in process cannot be recovered if the server stops or restarts. Backups also are needed if you want the ability to resubmit messages to back-end applications or resend messages to partners. Backup files are stored in \<install directory>\common\data\backup, unless you specify otherwise.
• Post-processing script – The full path to an executable file that contains post-processing commands. This field is available for community integration delivery exchanges and partner trading delivery exchanges.