Trading configuration > Community trading pickups and partner deliveries > Fields for modifying community pickups and partner deliveries > Modify a pluggable server pickup or delivery

Modify a pluggable server pickup or delivery

After you create a pluggable server pickup or delivery, you can view and modify certain fields that define the object.

Pluggable server settings tab (pickup)

Server name – This field displays the name of the pluggable server.
Server class - This field displays the server class of the pluggable server.
Add custom settings for this pluggable server – Enter name/value pairs as custom parameters.

Pluggable server settings tab (delivery)

Directory name – Use the Browse button or type the full path for a unique directory where Activator picks up or routes messages, depending on whether the transport is used for sending or receiving. If the directory does not exist, Activator creates it for you. Use a unique directory name. When adding a file system transport, the delivery exchange wizard suggests a name. You may want to give the directory a name that indicates whether the transport is being used for inbound or outbound integration, receiving messages from partners or sending messages to partners. For example, for outbound integration you could name the pickup directory \data\out; for inbound integration \data\in.
Preserve original filenames – Select this if you want original file names to be preserved when Activator delivers messages. For binary messages, we recommend that you preserve original file names. Otherwise, Activator assigns a unique file name that does not readily identify the contents of the file. Preserving original file names also allows your back-end application to process binary messages based on their file names. This field applies to community integration delivery exchanges and partner delivery exchanges only.
Overwrite duplicate filenames – An option when you choose to preserve original file names. If duplicate file names are detected, Activator overwrites the existing file.
Sequentially number duplicate filenames – An option when you choose to preserve original file names. If duplicate file names are detected, the trading engine appends a number to the new file. For most transports, the appended number is consecutively numbered. For FTP and SFTP, however, the appended number is hexadecimal and looks like this: filename_c4.
Generate unique filenames – Select to have the system provide a unique file name instead of using the original name. This field applies to community integration delivery exchanges and partner delivery exchanges only. When selected, files are given arbitrary names. The names always have less than 30 characters and often have less than 20 characters.
Appended to the file name is a hex representation of a monotonically increasing file name counter that is maintained in the database and 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.
The following are examples of unique file names generated by the system, one with the original file extension and one without:
- dabeed45_4cb.edi
- z47e4120_4ce

Advanced tab (pickup)

Maximum concurrent connections (for trading pickups only)– The number of total open connections Activator server can make to a partner.
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 or a processing node 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.
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 specific processing to the messages that you consume through this pickup. If you select this option you can then select a service to supply the processing.
- Services – From the drop-down list, select the service to use for message 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. If received via HTTP, a 413 response also is sent and the connection is closed. A 413 message is Request Entity Too Large. The maximum size must be expressed in bytes. Do not use commas. For instance, 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. This control is available only for transports used for picking up messages from integration or receiving messages from partners.
Post-processing script – The full path to an executable file that contains post-processing commands.
Maximum files per polling interval – The highest number of messages the system can retrieve each time it polls.
Polling interval (seconds) – The interval in seconds Activator waits before polling for messages to retrieve.
Maximum messages per connection – Default = 1. The maximum number of messages to be consumed over a single connection before the connection is closed and reopened on another processing node. This setting effects load balancing. Depending on your message volume and the load on each node, this value can be modified to control the overhead associated with reconnecting to the transport server.

Advanced tab (delivery)

Delete file after it is downloaded – Select this if you want the server to delete files after they have been downloaded from it.
Allow SFTP clients to add, remove subdirectories
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 or a processing node 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.
Process consumed messages using community collaboration settings – Select this option if you want Activator to perform routing using normal community collaboration settings. When you select this option, no B2Bi-related processing is performed on consumed messages.
Perform content processing on consumed messages – Select this option if you want to apply processing to the emails you pick up 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 – Select this option to specify the maximum size of files a the exchange can handle.
If Activator receives a file larger than the maximum, the file is rejected and a message is written to the events log.
- Maximum file size – Enter the maximum file size in bytes. Do not use commas.