Creating an AS2 Relationship for Multiple Organizations Reference

AS2 Relationship Page

Field Description

Organization

Name of the organization. Required.

Note: As you type, a list appears with matching entries. Double-click an entry to select it.

Partner

Name of the trading partner. Required.

Note: As you type, a list appears with matching entries. Double-click an entry to select it.

Notifications and Retries Page

Field Description

Retry Interval (sec)

The interval (in seconds) after which messages will be requeued and an attempt will be made to resend them (after a send failure). Default is 300. Required.

Max Retries

The maximum number of retries that should be attempted after repeated send failures. Required. Default is 5.

Notify on Immediate Failures

Select this check box to be notified immediately after a send attempt fails. Default is selected (this functionality is turned on).

Notify on Final Failure

Select this check box to be notified after the maximum number of retries (Trading Partner Max Retries) have been exhausted. Default is selected (this functionality is turned on).

Wait For Synchronous MDN Process To Complete Before Extracting Data:

Select this check box to wait for the synchronous MDN process to complete before extraction of data.

Store AS2 Messages in File System

Stores your AS2 messages in the directories you choose in this procedure. Required.

AS2 messages are stored in the directories you choose or, by default are stored in:
  • <Path to Install_dir>/as2partner/<Organization Identity Name>/<Partner Identity Name>/outbound
  • <Path to Install_dir>/as2partner/<Organization Identity Name>/<Partner Identity Name>/inbound
  • <Path to Install_dir>/as2partner/<Organization Identity Name>/<Partner Identity Name>/error
Note: If the relationship that is being created is with the organization that was existing before upgrade then the collection and extraction directory structures will follow old convention. For example, for the collection folder, the directory structure would be as follows:Path to Install_dir/as2partner/Partner Identity Name/Outbound

Store AS2 Messages in Mailbox

Store AS2 Messages in Mailbox.

Note: You must have a Mailbox Edition license to access the Mailbox feature.
AS2 messages are stored in the mailboxes you choose or, by default are stored in:
  • AS2/<Organization Identity Name>/<Partner Identity Name>/Outbound
  • AS2/<Organization Identity Name>/<Partner Identity Name>/Inbound
  • AS2/<Organization Identity Name>/<Partner Identity Name>/error
Store AS2 Messages in Global Mailbox Use Global Mailbox to store AS2 messages. You can use the default inbound and outbound mailboxes or specify an existing global mailbox.
Invoke Business Processes Directly Invokes the configured business processes directly without sending the messages to a file system or mailbox.

Collection Page

Field Description

Collection folder

Directory that contains outgoing (outbound) documents to your trading partners. Required. The default directory is install_dir/as2partner/<Organization Identity Name>/<Partner Identity Name>/outbound.

Extraction folder

Directory that contains incoming (inbound) documents from your trading partner. Required. The default directory is install_dir/as2partner/<Organization Identity Name>/<Partner Identity Name>/inbound.

Error log folder

Directory to which errors are written for outgoing (outbound) documents that contain errors (for example, if the AS2 Edition cannot send a document because of an invalid IP address, the Sterling B2B Integrator AS2 Edition generates an error log and saves it in this folder). Required. The default directory is install_dir/as2partner/<Organization Identity Name>/<Partner Identity Name>/error.

Max files to Collect

The number of files that are picked up from the collection folder each time that the scheduled business process executes. Valid values range from 0 to 500. The default value is All. Optional.

Run service based on a timer every

Hours and minutes for which to run the File System adapter. The default time is five minutes. Required.

Use Message File Name to Save File

Attempts to use the filename specified for the document in the message received from the trading partner to save the file. If your trading partner sends multiple messages with the same included filenames, existing files with the same names (that is, files currently in the inbound directory) may be overwritten.

Include File Name in Message

Includes the name of the file in the message when building messages to send to a trading partner. Valid values are:
  • None – Does not provide a file name in the message. This is the default.
  • File Name Only – Provides only the file name in the message.
  • Full Path – Provides the full path to the file in the message.

Mailbox Page

Field Description
Mailbox Realm Read-only field that shows which mailbox is used traditional or global. Default values are Traditional or Global.

Use Default Inbound/Outbound Mailboxes

Whether to use the default inbound and outbound mailboxes. The default mailboxes are: /AS2/<Organization Identity Name>/<Partner Identity Name>/Inbound and /AS2/<Organization Identity Name>/<Partner Identity Name>/Outbound

Select Existing Parent Mailbox

If desired, select a parent mailbox where the mailbox you are creating will be embedded. If you do not want to embed the mailbox, select the slash (/). Creates two mailboxes with the format Parent Mailbox/Inbound and Parent Mailbox/Outbound, where Parent Mailbox is the mailbox you selected.

Specify the full path to an existing mailbox.

Do not use the Global Mailbox path in an existing relationship. For example if you enter /mymailbox/mb1 and if the path is already used in the relationship, a validation message is displayed.

Note: All failed messages are placed in the Dead Letter Mailbox.

Business Process Page

Field Description
Inbound Success Business Process The Success business process that is invoked upon successful completion of inbound AS2 core processing. Required.
Inbound Error Business Process The error business process that is invoked when there is an error in inbound AS2 core processing and AS2Inbound BP goes into on-fault. Optional.
Set Message File Name in Process Data Whether to extract the inbound message file name to Process Data. Optional. The default is not selected (that is, do not extract the inbound message file name).
Include File Name In Message Whether to include the file name in the message. Optional. The default is not selected (that is, do not include the file name in the message).