Manage mailboxes

You can use the staged HTTP servlet user interface to manage mailboxes and the files they contain. A mailbox is a web server directory. Partners connect to the web server via the URL for a specific mailbox. Files the partner sends are written to a temp directory and then moved to the mailbox when fully received. The sponsor’s trading engine retrieves the files from the mailbox with the same URL.

You can perform the following tasks in the UI:

  • Add, edit and delete mailboxes
  • View files in mailboxes
  • View running totals for file uploads, downloads and deletions
  • View and change global settings for the servlet

The following topics describe how to perform various tasks.

Add a mailbox

Use this procedure to add a mailbox.

  1. Click New Mailbox at the top of the staged HTTP configuration manager page to display the mailbox maintenance page.
  2. In the URL field, type a directory name where inbound files are written. As you type the name, it is appended to the URL in the URL field.
  3. The partner connects with this URL to POST documents to the servlet directory. Interchange connects with the same URL to pick up documents.
  4. When you give the URL to the partner or Interchange administrator, you must add the domain and port of the web server. For example, the mailbox maintenance page displays a URL like this:
  5. http://webserver/webmailbox/partner
  6. But you must add the domain and port to the URL before passing it along. The URL you provide must be in this format:
  7. http://webserver /webmailbox/partner
  8. In the Company Name field type the name of the partner using this mailbox.
  9. Select the users who can access this mailbox with their user IDs and passwords. The remoteuser and ecengine users are displayed by default, but not selected. To add a user not displayed, click Add Privilege. You can select to allow users read and/or write access depending on the user type.
  10. The # instances permission for users represents the number of clients that can concurrently access the mailbox. In most cases, make this a large number (for example, 1000000) to make sure partners can connect to the servlet.
  11. Click Save Mailbox to close the mailbox maintenance page and save the mailbox.

Related topic

Partner connection to staged HTTP

A default remote user is included with the deployment, or you can add a user to the web server and have one or more partners connect using it. Partners should not use the ecengine user to connect.

A user name and password must always be used to send to the staged HTTP servlet. It is not recommended to use the standard ecengine user for this purpose, as that user also has permissions to read from the staged HTTP servlet. A new user can be used for the purpose of sending to the staged HTTP servlet, as long as the user and its role are configured properly in the web server. If a new role is configured, edit stagedhttp/WEB-INF/web.xml and add the role to the auth-constraint element in the security-constraint in the following figure, auth-constraint section of the web.xml file.

Related topic

Edit, delete, view mailboxes

To edit, delete or view contents of mailboxes, select a mailbox on the staged HTTP configuration manager page and click the action you want on the top toolbar.

Related topic

Global settings

You do not normally need to change settings on the configuration manager Global Settings page, with the possible exception of the synchronous request timeout setting. This setting controls how long a connection stays open while waiting for a response over the same connection. An advanced user may have a reason for changing the default time of 600 seconds.

Related topics

Related Links