Configure the AS2 service primarily at the parent Local and the trading partner AS2 remote hosts levels.
Configuring AS2 Service
- Expand the Local Listener node in the tree pane and then click the AS2 node.
- Specify parameter values as appropriate.
See Local Listener AS2 Service reference for information about the parameters available.
- Click Apply.
Local Listener AS2 Service reference
- Resource Path
- Defaults to /as2. Your trading partners must include this resource path in the URL when sending AS2 messages. You can change it at any time, but it must start with a forward slash (/) character. If you specify just a forward slash (/), the AS2 service is considered the default HTTP service, and any received message not matching any other HTTP service's resource path is automatically piped to the AS2 service. (This is primarily for compatibility with previous versions of the VersaLex application, which did not make use of resource paths for incoming messages.)
- My External Address
- The IP address used to access your computer or server from the Internet. This is the address where the VersaLex application is installed and running.
- This can be either a fully qualified host name (recommended) or a static visible external IP address.
- You can use the Set Address button to set your external IP address.
- Contact your systems administrator if you do not know your external IP address or fully qualified host name.
Advanced Feature: When you want an asynchronous MDN and you are using inbound port mapping on your firewall, you can specify the port where asynchronous MDNs should be received in the My External Address field. Enter the value in the form,address:port, for example, CLEO.DFICOMM.COM:80. This allows the asynchronous MDN requests to set the correct external address:port without adding/enabling that port in the Local Listener.Note: This entry will be overridden if you specify a non-zero Async MDN Preferred Port for the specific trading partner. See AS2 Host: Advanced Tab.
- MDN Storage Folder
- The folder where Message Disposition Notifications (MDNs) are stored. By default this directory is pre-defined to be a subdirectory under the VersaLex directory tree. Click …, navigate to a new path and folder, and click Apply.
- Generate Filename Preservation MDN Responses
- Select the Generate Filename Preservation MDN Responses option if you choose to check for duplicates of the same file name received from a specific trading partner. When selected, duplicate file names received from a particular trading partner within a desired number of hours, specified with the Retain Filename History property (the default value is 24 hours), will generate either a warning or error disposition in the MDN returned to the trading partner, depending on the setting of the Duplicate Filename Action. See AS2 Host Configuration for detailed information on the usage of the Filename Preservation feature.
- Restarts Storage Folder
- The Restarts Storage Folder is used as a temporary working directory for incoming files. If a trading partner requests a restart of a previous incomplete transfer, the file restart position is determined based on the temporary payload and corresponding property file in this directory. The temporary payload files are encrypted and the restart files are cleared once the transfer completes or 24 hours has passed. If the VersaLex application is being synchronized, the Restarts Storage Folder should be set to a shared location between all the synchronized VersaLexes because restart requests could come to any VersaLex instance.
- Retain Message ID History
- The number of days message ID history is retained for checking for and reporting duplicate messages (with the same Message-ID header value) from your trading partners. The default is 5 days.
Working with MDNs
A message disposition notification (MDN) is an acknowledgment sent in response to an AS2 message.
Use the MDNs tab to view MDNs received by remote hosts.
View the details of any particular MDN entry in the table by either right-clicking on a specific row and choosing Display from the pop-up menu, or by double-clicking on any row to display a detail window containing the contents of the MDN:
The Cleo Harmony, Cleo VLTrader, and Cleo LexiCom applications append tracking information to the MDN, including the Message Integrity Check (MIC) value it computed, the name of the file, and the date and subject of the message that was sent. It also includes information about the sender and recipient of the message and how the message was assembled, for example, whether it was signed, encrypted, compressed, and so on.
Use the Copy button to copy MDN information to the clipboard. Use the Print button to print MDN information. Alternatively, right-click an MDN entry and select Print from the menu.
Resending or canceling a pending message
When a message has been sent requesting an asynchronous MDN, its initial Status is Pending. It will remain in this status until either the asynchronous MDN is returned or the values of the Async Timeout and Async Resends have been exhausted. See Specifying Local Listener advanced properties.
You can resend or cancel MDN entries with a status of Pending.
- Right-click the message you want to resend or cancel.
- Choose one of the following:
- Resend Now - resend the message to your trading partner. This can only be done before the asynchronous timeout has expired.
- Cancel - remove the associated files in the AS2\unsent folder, change the status of the message to
User Cancelled, and stop any additional resend attempts. Use this option when it is clear that the asynchronous MDN will not be returned.
Filtering the MDN list
Use the Status drop down menu to filter the MDN entries displayed. By default, the filter is set to Any and all MDNs are displayed. If no entries match the filter, no MDNs entries are displayed.
You can manually archive MDN files from the MDNs tab. The Cleo Harmony, Cleo VLTrader, and Cleo LexiCom applications store archived MDN files as mdn.zip files in the AS2\mdn\archive directory.
- Hold down the Ctrl key and click rows to select them. Alternatively, select a series of rows by holding down the Shift key and selecting the first and last row.
- While still holding down the Ctrl or Shift key, right-click to display the menu.
- Release the Ctrl or Shift key and select Archive from the menu.
Note: For the web UI, it is particularly important to release the Ctrl or Shift key prior to making the menu selection, as keeping it depressed could invoke another browser tab.
The files are stored in compressed/zip format in the AS2\mdn\archive directory. Files included in the archive are removed from the AS2\mdn directory and the MDNs are removed from the display.
The Cleo Harmony, Cleo VLTrader, and Cleo LexiCom applications also automatically archive MDNs after a specified number has been received. Set this value in the Archive Automatically After Maximum Receipts field on the Local Listener Advanced tab. See Specifying Local Listener advanced properties.