SI52 Mailbox Book

Sterling B2B Integrator
IBM
Mailbox
Version 5.2
Sterling B2B Integrator
IBM
Mailbox
Version 5.2
Note
Before using this information and the product it supports, read the information in Notices on page 37.
Copyright
This edition applies to Version 5 Release 2 of Sterling B2B Integrator and to all subsequent releases and
modifications until otherwise indicated in new editions.
Copyright IBM Corporation 2000, 2015.
US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Mailbox . . . . . . . . . . . . . . . 1 Search for Correlations to Business Processes . . 25
Get Started with Mailbox . . . . . . . . . .1 Audit Restored Messages . . . . . . . . . 25
Quick Tour of Mailbox . . . . . . . . . .1 Monitor EDIINT Activity . . . . . . . . . 26
Mailbox System Components . . . . . . . .2 View Dead Letter Mailbox Contents and Status 27
Integrate Mailboxes with an Application . . . . .3 Configure an AS2 Trading Partner to Use
Integrate Mailboxes with Services . . . . . .3 Mailbox . . . . . . . . . . . . . . 27
Mailbox Services . . . . . . . . . . . .4 Troubleshoot AS2 Mailbox Issues after a System
Routing Rules for Mailboxes . . . . . . . .7 Failure . . . . . . . . . . . . . . . 28
Manage Your Mailbox . . . . . . . . . . . 11 Determine AS2 Mailbox File Routing Status after
Organize Your Mailboxes . . . . . . . . . 11 a System Failure . . . . . . . . . . . . 28
Create a Mailbox and Assign Permissions . . . 13 Delete Mailboxes . . . . . . . . . . . 29
Create a Submailbox and Assign Permissions . . 14 Mailbox Browser Interface (MBI) . . . . . . . 30
Mailbox Permission Rights . . . . . . . . 15 Configure the Mailbox Browser Interface (MBI) 30
Edit a Mailbox Configuration . . . . . . . 17 Connect Trading Partners to the MBI . . . . . 31
Assign Mailbox Permissions . . . . . . . . 17 Change Your Password in the MBI . . . . . 32
Assign Users to Mailbox Groups . . . . . . 18 Keep Permissions Secure in the MBI . . . . . 33
Edit an Exported Mailbox File . . . . . . . 19 Search for Messages in a Mailbox . . . . . . 33
Create Virtual Roots . . . . . . . . . . 19 Send a Message to a Mailbox . . . . . . . 34
Edit Virtual Roots . . . . . . . . . . . 20 View a Message from a Mailbox Without
Search for Messages . . . . . . . . . . 20 Extracting . . . . . . . . . . . . . . 35
Display Message Name as Text . . . . . . . 21 Extract a Message from a Mailbox . . . . . . 36
Suppress Duplicate Messages . . . . . . . 22
Allow Duplicate Messages in /DeadLetter . . . 22 Notices . . . . . . . . . . . . . . 37
Update the Extractability of a Message . . . . 23 Trademarks . . . . . . . . . . . . . . 39
Resubmit a Message for Automatic Routing . . 24 Terms and conditions for product documentation. . 40
Archive Messages . . . . . . . . . . . 24
Restore Messages . . . . . . . . . . . 24
Copyright IBM Corp. 2000, 2015 iii

iv Sterling B2B Integrator: Mailbox
Mailbox
Mailbox offers document repositories accessible only to specific users and
applications. Use the Mailbox when it is necessary to store messages and
documents for processing at a later time.
For example:
v To stage data passing between internal systems and external trading partners.
v When data is produced by internal systems when trading partner systems are
unavailable.
v When requests are received from trading partners outside of processing
windows. Processing windows (time frames) are created to accommodate system
constraints such as scheduled maintenance or because of business constraints.
For example, it may be preferable to delay transmission of payments to the latest
date possible.
The definition, operation, management, and control of staging and scheduling are
centralized in Mailbox.
Get Started with Mailbox
Quick Tour of Mailbox

Mailbox is a secure business document repository with a store-and-forward
communication infrastructure. Mailbox provides facilities necessary to conveniently
build B2B electronic commerce communities.
Mailbox provides a trading partner browser interface called the Mailbox Browser
Interface (MBI). No special software is required when Mailbox is deployed to an
electronic trading community. The MBI is secure and simple to use, requiring no
special user training.
Although Mailbox can be used with almost any communication or B2B protocol
service, such as EDIINT AS1, SMTP or HTTP, for convenience, it has been tightly
integrated with AS2, the EDIINT service, and the HTTP/S communications
adapter. You can configure a system to use Mailbox to stage documents for internal
processing, while using the AS2 protocol for secure Internet-based document
transport. This feature provides a scalable and functional alternative to the File
System adapter with AS2.
Mailbox supports automated, scheduled, and manual processing of business

documents using routing rules. Routing rules provide a powerful and easy-to-use
mechanism for controlling document routing. Additionally, Mailbox is easily
combined with business processes, document translation, B2B protocols, and back
end system integration.
Business documents stored in Mailbox are called messages and can contain
business content in any format such as binary, EDI, or XML. Each message is
assigned an extraction policy that specifies the rules for extracting messages from a
mailbox. For example, when you add a message to a mailbox, you can process the
message immediately or at any scheduled time.
Copyright IBM Corp. 2000, 2015 1

Mailbox provides a hierarchical, OS platform-independent business document
repository. It therefore offers storage, organization, and management advantages
over the use of a file system. The repository provides many capabilities including
support for relative mailbox paths (virtual roots) and a dead letter mailbox. The
repository also provides efficient document storage. For example, multiple
mailboxes containing the same message share a single copy of the message.
A management user interface provides easy management of existing mailboxes and

routing rules.
Mailbox System Components

The Mailbox contains a series of components and features such as the Dead Letter
Mailbox, Mailbox Access Controls, and Document Publishing.
The system components and features of Mailbox are:
Component Description
Mailbox A storage area for business documents and provides an administrative
hierarchy that is easy to manage and understand. System users have
access to their documents, while administrators can organize and manage
documents across all mailboxes. Mailboxes form a hierarchy. The top of
the hierarchy is called the root mailbox and is denoted by a slash (/).
Mailboxes can support sub-mailboxes. This organizational concept is
referred to as a mailbox hierarchy.
Dead Letter Stores messages that cannot be added to a particular mailbox. The primary
Mailbox role of this mailbox is to provide temporary data storage until the
administrator can correct the problem.
Message A document existing in a mailbox. A message is assigned to a mailbox
with a name and timestamp. Mailboxes are acted upon by business
processes using services, which provide the ability to add, extract, query,
and delete messages.
Mailbox Enables the system administrator to assign mailbox privileges to groups
Access and users. Users who have the appropriate permissions in a mailbox can
Controls view, add, delete, and extract messages from the mailbox (using the
Mailbox Browser Interface) and can run business processes acting upon
the mailbox.
Global Mailbox Administrators, by default, have global privileges that enable the
Permission execution of operations across all mailboxes. The Mailbox Global Delete
Settings and Mailbox Global Query permissions are two such global privileges. For
example, a Mailbox Administrator can delete a mailbox because they have
the permission Global Mailbox Delete.
When necessary, Global permissions can be granted to other users and

groups.
Mailbox A mailbox associated with a trading partner. Every mailbox referenced by
Virtual Roots that user is evaluated relative to that user's virtual root. For example, if
the user's virtual root is /Customers/Central/Dallas Hardware and the
user runs an action to add a message to mailbox /Inbound, the actual
mailbox designated by the action will be /Customers/Central/Dallas
Hardware/Inbound. With the virtual root defined there is no need to
notify this trading partner when a change is made to the hierarchy - as
long as the administrator updates the trading partner's virtual root.
2 Sterling B2B Integrator: Mailbox

Component Description
Mailbox Enables Internet users to access their mailboxes from a standard Web
Browser browser. Users can send messages to, retrieve messages from, and search
Interface (MBI) messages in any mailbox for which they have permissions. The MBI also
enables users to change their account password.
The Mailbox Browser Interface is a Web system, and therefore requires

only a Web browser. No proprietary client software is required.
Scheduled Documents are collected from internal systems and external trading
Batch partners. All documents are processed together on a schedule, such as at
Processing the end of the day or week. For example, in Automated Clearing House
(ACH) handling in the banking industry, messages containing transactions
are received during the course of a day and placed into one or more
mailboxes. At the end of the day, all transactions are processed. Same-bank
transactions are processed internally. Transactions with other banks are
sent out for processing.
Asynchronous A hub may provide a trading partner with an inbound mailbox. The
Document trading partner may submit documents containing EDI transactions to that
Processing mailbox, where the document is processed. Each submission is processed
one time. For example, an electronics supplier wants to process purchase
orders as soon as they arrive. The electronics supplier instructs its trading
partners to send purchase orders to a mailbox. When orders arrive, a
business process extracts the order from the mailbox and passes it to a
back-end system for order processing.
Document Documents, such as a product catalog, may be published using a mailbox.
Publishing Authorized trading partners retrieve the document using a browser-based,
secure interface. After a period of time, the document expires and is no
longer available for retrieval. The following scenarios illustrate ways to
publish documents to a mailbox.
v A hardware supplier publishes a price list for a sale to their trading
partners. The hardware supplier places the price list in a mailbox and
grants trading partners access to the mailbox. The price list can be
extracted (downloaded) until the end of the sale.
v An insurance company publishes a document of all claims processed for
its clients of the past year. The company adds the claim detail to the
mailboxes of the individual clients and allows clients to extract claim
details for one year.
File Copying Files can be copied to and from the Mailbox through the Sterling
Connect:Direct Server adapter or the FTP Server adapter.
Routing Rules Initiate action automatically when a message is added to a mailbox.
Integrate Mailboxes with an Application
Integrate Mailboxes with Services

You can integrate Mailbox with any service or adapter by designing business
process models using the Graphical Process Modeler.
In addition, Mailbox provides ready-to-use integration with the EDIINT AS2

protocol. This support is provided through special pre-built business process
models and an AS2 Setup Wizard.
The FTP Server adapter is tightly integrated with the mailbox subsystem. The
Sterling Connect:Direct Server adapter can be used to copy files to and from the
Mailbox.
Mailbox 3
Integrate Mailboxes into Business Processes
You can integrate Mailbox with business processes by:

v Invoking the Mailbox services from a business process
v Specifying a business process using a routing rule
Integration Examples
Following are examples of how you can integrate the mailbox into business
processes:
Integration
Type Example
Event-Driven You can use the mailbox for event-driven near real-time integration. Set up
Integration an automatic routing rule that searches a specific mailbox for a message
name pattern. When the routing rule is evaluated, the message in the
designated mailbox is matched, and a designated business process is
triggered. The business process can access the contents of the message and
perform automation functions like back-end systems processing or
notification to an interested party. Event-driven processing is useful when
your business requirements dictate that documents arriving in a mailbox
should be processed as soon as possible after arrival.
Time-Driven You can use the mailbox for time-driven integration with your business
Integration processes. To do this, set up a business process that runs on a time
schedule and uses the Mailbox Query service to search the mailbox for
specific message criteria. When matching messages are found, the next
step in the business process is started. The business process can do
anything with the matched message, such as extract it and pass it to
another system or notify a person that the message is available for them.
This system of the mailbox is useful where scheduled processing is

important such as end of month payments. Messages received in the
mailbox are processed at the next scheduled run of the business process.
Document You can use the mailbox to publish documents for a specified period of
Publishing time. Create a business process to add a document to a mailbox and set
the extract policy ExtractableUntil, specifying the date you want the
document to expire. Give permissions to this mailbox to anyone that will
view the document. Users can extract the document until the date you
specified has passed. A common system of this is making a catalog
available to customers, until the catalog expires.
Mailbox Services
Mailbox services allow you to add, extract, query, or delete messages.
Mailbox Add Service
The Mailbox Add service enables you to add messages to a particular mailbox. The
service enables the specification of a message name, the mailbox where the
message should be added, and the extraction policy. Before the Mailbox Add
service runs, it verifies a users permission to use a mailbox. The primary role of
this mailbox is to provide temporary data storage until the administrator can
correct the problem.
One of three extraction policies is assigned to a message when it is added to a

mailbox. These policies control when extraction of a message is allowed. The
following table describes the extraction policies:
Policy Description
Extract a Carries a count, which is reduced each time the document is extracted.
limited Following are two ways you can use this policy:
number of v When the count is one, the message is like a normal letter placed into a
times drop-box. After the message is extracted once, it is no longer available.
v When the count is greater than one, the message is available to multiple
users. The extraction succeeds, but after the count goes to zero, no one
can extract the message.
Extractable Enables extraction until the date is reached and disables extraction after
until some the date is passed. This policy is like a coupon that expires on a certain
future date date.
Extractable (or Enables or disables all extractions until an administrator changes the
not) until policy.
further notice
Mailbox Extraction Services
Extraction is the term for reading a message from a mailbox, typically into the
primary document of a business process. Extracting a message within a business
process consists of two steps:
1. The Mailbox Extract Begin service verifies permissions, availability and
extractability. If the operation is allowed, the data is provided to the business
process.
2. After the business process has finished processing the data, the extraction can
be completed by invoking either the Mailbox Extract Abort service or the
Mailbox Extract Commit service. If there is an error after the Mailbox Extract
Begin service, the Mailbox Extract Abort service is invoked, which restores the
extractable count to the original value as if the Mailbox Extract Begin service
never took place. If no errors occur, the Mailbox Extract Commit service is
invoked, which formally completes the extraction.
If business processes do not need this failure handling, you can combine the
Mailbox Extract Begin service and the Mailbox Extract Commit service into a single
service by setting a parameter in the Mailbox Extract Begin service.
When a business process executes the Mailbox Extract Begin service, a message
hold table tracks the processing of a message by a particular business process.
Access to a message is controlled by the extraction policy.
It is possible that a user begins to extract a message, but then decides that it is not
possible to process the document. For example, a business process may extract a
message and send it to a trading partner over the network. If the transfer fails, the
extraction does not succeed (to prevent one of the limited copies of the message
from being extracted).
Mailbox Query Service
The Mailbox Query service enables you to select a similar grouping of messages.
For example, a user can use the Mailbox Query service to find messages added
between two dates. A user must have permission to query a mailbox.
The Mailbox Query service supports multiple parameters, including:

v Mailbox path
Mailbox 5
v Message name pattern
v Message ID
v User ID
v Start date and time
v End date and time
v Messages extractable
v Order by
v Ascending/descending
Mailbox Delete Service
The Mailbox Delete service enables you to remove outdated or obsolete messages.
This service supports a parameter list similar to that of the Mailbox Query service.
The user must either have permission on each of the mailboxes, or must have the
mailbox global delete.permission, which allows the holder to delete messages from
any mailbox.
Mailbox Delete Mailbox Service

The Mailbox Delete Mailbox service enables you to delete one or multiple
mailboxes, as well as the associated submailboxes, messages, virtual roots, routing
rules, and permissions. It is designed to completely and permanently remove
mailboxes and everything associated with them. The Mailbox Delete service differs
from the Mailbox Delete Mailbox service in that it deletes only messages in
mailboxes.
About this task
You can either delete mailboxes interactively, through the system interface, or at a
decision point in a business process, using the Mailbox Delete Mailbox service in a
business process.
To delete mailboxes interactively:
Procedure
1. Go to Deployment > Mailboxes > Configuration.
2. Next to List ALL, click Go!
3. Click the delete icon. You have the option to view a report of what was
deleted.
Mailbox Scheduled Delete Service

You can schedule your mailbox to delete messages meeting specified criteria.
The Mailbox Scheduled Delete service can delete mailbox messages meeting
criteria consisting of:
v Message name pattern
v Mailbox
v Extractability status
v Message age
For example, it is possible to create a configuration of the Mailbox Scheduled

Delete service to periodically delete all messages more than a week old.

The Mailbox Scheduled Delete service can be configured to run once at a specified
date and time, or periodically, such as once a month or twice a week.
Routing Rules for Mailboxes

You can create routing rules to initiate action automatically when a message is
added to a mailbox. Automatic routing ensures that the rule is evaluated at least
once.
When a message is added to a mailbox, any rules established for the Mailbox are
evaluated automatically. After evaluating automatic routing rules, any business
processes that the rules are configured to run start. The rules do not wait for the
business processes to complete. After all routing rules run (according to defined
schedules), the messages added to any mailbox since the last automatic routing
rule evaluation are removed from the needs to be routed table. After messages
are removed from that table, they are never again eligible for auto routing.
Manual and scheduled evaluation route all messages that meet the pattern of the
rule to be evaluated. If a message is in a mailbox and is included in a rules
pattern, that message is routed every time the rule is evaluated.
Manual and scheduled evaluation do not provide a guarantee that message will be
delivered at least once. Routing usually occurs once, but if a system outage occurs,
the routing does not resume at system start. If you restart the system, the business
processes that were started may need to be restarted, depending on whether the
processes are restartable or resumable.
After the system evaluates a routing rule, the routed messages are guaranteed to
be processed by the routing rule business process.
Routing Rule Pattern and Action

Routing rules consist of two parts: a pattern to specify when the rule applies, and
an action to be performed.
Routing rules contain string patterns used to match message names. This string
can contain wildcard characters. You can restrict the application of the rule to
specific mailboxes. When a message name matches the string pattern of a rule, the
rule triggers the execution of a designated business process. That process can
perform any processing, including extraction of the message and integration with
back-end systems or a notification action. For example, a routing rule may trigger
a business process that pages an administrator whenever a message arrives in the
Dead Letter mailbox.
Routing Rule Evaluation Modes

A routing rule evaluation mode is used to define when the rule is evaluated. You
establish the evaluation mode when you define the routing rule.
There are two routing rule evaluation modes-Automatic and Manual.
Automatic routing rule evaluation is carried out by the Mailbox Evaluate All
Automatic Rules service. It is a scheduled service, and its frequency is controlled
through the Application interface. Messages are eligible for automatic evaluation
only once as they are added to a mailbox.
All messages are always candidates for manual evaluation of routing rules. A
message may be routed multiple times if a routing rule is manually evaluated
repeatedly.
Mailbox 7
There are three ways to manually evaluate a routing rule:
v A routing rule can be manually evaluated within a business process by calling a
configuration of the Mailbox Evaluate Routing Rule service.
v A routing rule can be manually evaluated by a scheduled configuration of the
Mailbox Evaluate Routing Rule service.
v A routing rule can be manually evaluated interactively through the Application
interface.
Adjust the Evaluation Frequency

An administrator may want to reduce the frequency with which mailbox routing
rules are evaluated in order to reduce the overhead of the system resources that
are consumed each time a service is invoked.
About this task
Evaluation of the routing rules involves database queries followed by the start of
various business processes, as specified in the routing rules. An administrator can
balance the need for timely routing of messages against the overhead of the
routing process.
Note: Frequency adjustment pertains only to the evaluation of automatic routing

rules not to routing rules, in general.
To adjust the evaluation frequency:
Procedure
1. From the Deployment menu, select Schedules.
2. Search for the MailboxEvaluateAllAutomaticRules schedule and click the edit
icon.
3. Redefine the frequency for routing rule evaluation.
Evaluate a Routing Rule at a Different Frequency

If you have a routing rule that you want evaluated at a different frequency than
that of the Mailbox Evaluate All Automatic Rules service, you may use the Mailbox
Evaluate Routing Rule service to allow a business process to evaluate a routing
rule. You can schedule this service.
About this task
The minimum configurable routing interval is one minute (as determined by the
Application scheduler).
To evaluate a routing rule at a different frequency:
Procedure
1. Create a configuration of the Mailbox Evaluate Routing Rules service that
evaluates the appropriate routing rule, and set its schedule to the frequency
you want. The schedule is configurable from the service definition page.
2. Add this Mailbox Evaluate Routing Rules service configuration to your
business process.
3. Designate the routing rule to be evaluated at a different frequency as a manual
routing rule, so that it will not be evaluated by the Mailbox Evaluate All
Automatic Rules service.

Create a Routing Rule
When a routing rule is evaluated, Mailbox searches the mailboxes defined in the
rule for message names that match the pattern defined in the rule. When a match
is found, the routing rule notifies the business process or contract specified in the
routing rule.
About this task
Depending on how the business process is defined, it may extract and process the
message, extract the message and pass it to another system for processing, or
notify another system to extract and process the message.
If routing rules are set to be evaluated manually, they can be evaluated by a user
or a business process.
Use the following procedure to create a routing rule:
Procedure
1. From the Deployment menu, select Mailboxes and Routing Rules.
2. In the Create section, click Go!
3. Specify a Name for the routing rule. This name must be unique for each
routing rule. It is used to identify the routing rule in other parts of
Application.
4. In the Rule Application page, select the Evaluation Mode:
v Evaluate Manually - The rule must be evaluated manually or evaluated
using a scheduled business process.
v Evaluate Automatically - The rule is evaluated every minute.
5. Select the Action Type:
v Business Process - The rule notifies a business process when a match is
found.
v Contracts - The rule notifies a business process associated with a contract
when a match is found.
6. Click Next.
7. In the Rule Pattern page, use the arrows to add the mailboxes to the Selected
Mailboxes list. All groups in the Selected Mailboxes list are searched by the
routing rule. Click the double arrow to add all available groups to the
Selected Mailboxes list.
8. Specify the Message Name Pattern and click Next. This is the message name
or pattern that the routing rule searches for in the mailboxes specified. You
can use an asterisk for a wildcard. You must specify a mailbox, a message
name pattern, or both.
9. In the Rule Action page, select the associated business process (or filter by
name) and click Next.
10. In the Run Rule as User page, select the user ID that is associated with the
routing rule when it is run.
11. In the Confirm page, verify the parameters and click Finish.
12. When the system update is complete, click Return.
Edit a Routing Rule

You can change one or more routing rule parameters. Editing these system
generated rules affects communications with trading partners.
Mailbox 9
About this task
There are routing rules created by the AS2 wizard. These rules contain the phrase
Routing Rule created automatically by the AS2 Wizard in the Description column of
the search results screen.
Procedure
1. From the Deployment menu, select Mailboxes and Routing Rules.
2. Select the routing rule you want to edit using one of the following methods:
v In the By Mailbox Name field of the Search section, type the mailbox ID
associated with the routing rule and click Go!
v In the List section, select the first letter of the routing rule name or select
ALL for a list of all routing rules and click Go!
3. Identify the routing rule you want to edit and click the edit icon in the Select
column.
CAUTION:
Rules containing the phrase Routing Rule created automatically by the AS2
Wizard for xxx in the Description column are system-generated rules. Editing
these rules affects communication with trading partners.
4. In the Rule Application page, select the Evaluation Mode:
v Evaluate Manually - The rule must be evaluated manually or evaluated
using a scheduled business process.
v Evaluate Automatically - The rule is evaluated with the frequency specified
in the Mailbox Evaluate All Routing Rules service.
5. Select the Action Type:
v Business Process - The rule notifies a business process when a match is
found.
v Contracts - The rule notifies a business process associated with a contract
when a match is found.
6. Click Next.
7. In the Rule Pattern page, use the arrows to add the mailboxes to the Selected
Mailboxes list. All groups in the Selected Mailboxes list are searched by the
routing rule. Click the double arrow to add all available groups to the
Selected Mailboxes list.
8. Specify the Message Name Pattern. This is the message name or pattern that
the routing rule searches for in the mailboxes specified. You can use an
asterisk for a wildcard. Specify a mailbox, a message name pattern, or both.
9. Click Next.
10. In the Rule Action page, select the associated business process (or filter by
name) and click Next.
11. In the Run Rule as User page, select the user ID to associate with the routing
rule when it is run.
12. In the Confirm page, verify the parameters and click Finish.
13. When the system update is complete, click Return.
Manually Evaluate a Routing Rule

You can manually evaluate a routing rule under the Deployment menu.
About this task
To manually evaluate a routing rule:

Procedure
1. From the Deployment menu, select Mailboxes > Routing Rules.
2. In the Evaluate Routing Rules section, click Go!
3. From the Available Rules list, select the rules you want to evaluate and click
the right arrow button to move it to the To Be Evaluated list and click Next.
4. Click Finish.
The Update system page opens with an Evaluation Report. To view the
message IDs that were evaluated, click the Evaluation Report.
Manage Your Mailbox
Organize Your Mailboxes

When designing your Mailbox, you must consider how you will use routing rules
and the Mailbox Query service to interact with mailboxes. Routing rules and the
Mailbox Query service enable you to search for messages based on mailbox path,
mailbox name, and message name.
Following are two examples of how routing rules and the Mailbox Query service
relate to mailbox organization.
Example 1 - Message Name Suffix
Mailbox Name and Two trading partners, Dallas Hardware and Chicago
Hardware, will be sending purchase orders to the mailbox. A routing rule or
Mailbox Query service is set up to search for messages in the /Customers/Central
United States/Dallas Hardware mailbox and /Customers/Central United
States/Chicago Hardware mailbox. They will look for messages with the suffix .po.
When matching messages are found, a business process is notified and the Dallas
Hardware purchase order is processed.
When the routing rule is evaluated or the Mailbox Query service is run, any
messages with the suffix .po that are in the Dallas Hardware or Chicago Hardware
mailboxes are identified, extracted and processed by a business process.
The following figure represents a possible organization of mailboxes that uses

mailbox name and the message name for routing rules or the Mailbox Query
service:
Mailbox 11
Example 2 - Mailbox Name, Message Name, Message Name
Suffix
Two trading partners, Seattle Electronics and LA Electronics, will be sending
purchase orders. One routing rule is set up to search for messages in the
/Customers/Western United States/Purchase Orders mailbox and will look for
messages named SeattleElectronics.po. Another routing rule is set up to search for
messages in the /Customers/WesternUnited States/Purchase Orders mailbox and
will look for messages named LAElectronics.po. Each will notify a business
process.
When the routing rules are evaluated, any messages with the name
SeattleElectronics or LAElectronics and suffix .po notify a business process.
The following figure represents a possible organization of mailboxes that uses

mailbox name, message base name, and the message suffix for routing rules:
Organize Information using the Mailbox Name

The mailbox name is the actual name assigned to the mailbox at the time of
creation. Mailbox names are useful for general communication purposes, for
example, informing trading partners about where to send documents they have for
you.
Mailbox structures are nested. When you create a new mailbox, it must be nested
within another mailbox. At a minimum, the virtual root mailbox / is a starting
point from which to build the mailbox structure. Consider an example where
someone creates a mailbox with the name Inbound in the / virtual root
mailbox, and then adds sub-mailboxes to it for specific trading partners:
/Inbound
Company A
Company B
Company C
In this case, the mailbox names are Inbound, Company A, Company B, and
Company C.
The mailbox name can identify information such as trading partner name or the
direction of message flow. Following are two examples:

v A message from the trading partner Dallas Hardware may be stored in the
Dallas Hardware mailbox.
v A message received from Dallas Hardware Incorporated will be stored in a
mailbox named /Customers/Central United States/Dallas Hardware/Inbound,
and a message sent to Dallas Hardware Incorporated will be stored in the
mailbox /Customer/Central United States/Dallas Hardware/Outbound.
Organize Information using the Mailbox Path

The mailbox name alone is not sufficient for business process activities that
perform operations on mailboxes (for example, adding or extracting messages). For
these activities, the mailbox path is required. The mailbox path represents the full
sequence of mailboxes and sub-mailboxes that specifies the location of a certain,
named mailbox.
For security/privacy reasons, though, you may not want trading partners to be
aware of the nesting structure for your mailbox system. In the above example, you
may only want Company A, Company B, and Company C to be aware of their
own individual mailboxes.
In the example above, the mailbox path for Company A is:

/Inbound/Company A
Your trading partners do not need to know the mailbox path for their mailbox.
However, services used to perform operations on mailboxes require the mailbox
path.
The path to a mailbox can identify information such as the category of trading
partner. For example, mailboxes for customers from the Central United States may
be embedded inside a mailbox named Central United States such as
/Customers/Central United States/Dallas Hardware.
Organize Information using the Message Name

The message name can be used to communicate information about the message
using a suffix, base name, or prefix.
The following are three examples:

v A purchase order may be sent with a message name suffix that indicates it is a
purchase order, such as 9912234.po.
v A message representing transaction ID 9912234 may have a message name
9912234.po.
v The order-123456767.request and order-123456767.cancellation might be part of
an order process, while invoice-234325677.receipt might be part of an invoice
process.
Create a Mailbox and Assign Permissions

You can create a new mailbox and assign permissions to groups and user to
operate on a mailbox under the Deployment menu.
About this task
To create a new mailbox and assign permissions to groups and users to operate on
this mailbox:
Mailbox 13
Procedure
1. From the Deployment menu, select Mailboxes > Configuration.
3. In the Mailbox: Name page, select the parent mailbox in which the mailbox you
are creating will be embedded. You can type a partial name in the Filter by
Name field and click the filter button for a filtered list. The root mailbox is
denoted by a slash (/).
4. In the Name field, type a name for the mailbox you want to create. This name
is used to identify the mailbox in Application.
5. In the Description field, type a short description for the mailbox and click
Next. Use this field to describe the mailbox. This field is not used by any other
resource in the system. (This is a required field.)
6. In the Assign Groups page, use the arrows to add the groups to the Selected
Groups list and click Next. All groups in the Selected Groups list will have
permissions on this mailbox. Click the first double arrow to add all available
groups to the Selected Groups list. You can type a partial group name in the
Filter by Name field and click the filter button for a filtered list. No groups are
required. Groups can be added from the Accounts menu.
7. Use the arrows to add users to the Selected Users list and click Next. All users
in the Selected Users list will have permissions on this mailbox. Click the
double arrow to add all available users to the Selected Users list. You can type
a partial user name in the Filter by ID field and click the filter button for a
filtered list. No users are required. Users can be added from the Accounts
menu.
Create a Submailbox and Assign Permissions

After you create a mailbox, your can create submailboxes. You can do this by
creating a mailbox again or you can create a submailbox.
About this task
Use the following procedure to create a submailbox:
Procedure
2. Open the configuration data of the mailbox you want to edit using one of the
following methods:
v In the By Mailbox Name field of the Search section, type the name or
partial name of the mailbox you want to edit and click Go!
v In the Alphabetical section, select the letter the mailbox starts with or select
all to pull a list of all mailboxes and click Go!
3. A list of available mailboxes opens. Click the Create sub-mailbox icon next to
the mailbox you want to create a submailbox in.
4. In the Mailbox: Name page, the parent mailbox is specified for you. The root
mailbox is denoted by a slash (/).
5. In the Name field, type a name for the mailbox you want to create. This name
is used to identify the mailbox in Application.
6. In the Description field, type a short description for the mailbox and click
Next. Use this field to describe the mailbox. This field is not used by any
other resource in the system. (This is a required field.)

Filter by Name field and click the filter button for a filtered list. No groups
are required. However, if you want administrators to have access using the
MBI, you must assign permissions to the Mailbox Browser Interface Group or
to the Admin user.
8. In the Assign Users page, use the arrows to add users to the Selected Users
list. All users in the Selected Users list will have permissions on this mailbox.
Click the double arrow to add all available users to the Selected Users list.
You can type a partial user name in the Filter by ID field and click the filter
button for a filtered list. No users are required. Users can be added from the
Accounts menu.
9. Click Next.
10. In the Confirm page, verify your mailbox configuration and click Finish.
Mailbox Permission Rights

Mailbox users are able to access and perform specific functions based on the
service or adapter component being used and the rights that are permitted. The
assigned rights are at the mailbox level, and apply to all messages in the mailbox.
Each right is mapped to a specific function:

v Read - Allows users to get messages from a mailbox.
v Write - Allows users to put messages into a mailbox.
v View - Allows users to list mailboxes or messages.
v Execute - Allows users to access a mailbox.
v Delete - Allows users to delete messages from a mailbox.
Note: By default, users are assigned all rights.
Rights and Functions
Components interact with mailboxes on behalf of the user. To perform the

functions, the user must have the indicated right and permission. If the component
tries to perform the function without the appropriate right and permission, the
operation will fail.
The following table displays the rights required to perform the specified functions:
Component Function Right Permission

Advanced File Replay message into Write Mailbox
Transfer (AFT) mailbox.
Sterling Connect Read from mailbox. Read Mailbox
Direct Server
Adapter
Write to mailbox. Write Mailbox
FTP Server Adapter Add message to mailbox. Write Mailbox
Extract message from Read Mailbox
mailbox.
List submailbox. View All mailboxes from
virtual root submailbox
Mailbox 15
List virtual root mailbox. View Virtual Root Mailbox
List virtual root mailbox Execute MailboxLoginWithout
without mailbox execute VirtualRootPermission
permission.
Login to the virtual root Execute Virtual Root Mailbox
mailbox.
Login to the virtual root Execute MailboxLoginWithout
mailbox without mailbox VirtualRootPermission
execute permission.
Move message from Delete Source Mailbox
mailbox.
Move message to Write Destination Mailbox
mailbox.
Remove message from Delete Mailbox
mailbox.
Mailbox Add Service Add message to mailbox. Write Mailbox
Mailbox Delete Use service. Execute MailboxGlobalDelete
Mailbox Service
Mailbox Delete Use service. Execute MailboxGlobalDelete
Service
Use service without Delete All affected mailboxes
MailboxGlobalDelete.
Mailbox Extract Extract message from Read Mailbox
Begin Service mailbox.
Mailbox Query Use service. Execute MailboxGlobalQuery
Service
Use service without View All mailboxes in query
MailboxGlobalQuery.
Mailbox Update Update message in Write Mailbox
Service mailbox.
Mailbox XAPI Create message in Write Mailbox
createMessage mailbox.
Mailbox XAPI Extract message from Read Mailbox
beginExtractMessage mailbox.
SSH/SFTP Server Add message to mailbox. Write Mailbox
Adapter
mailbox.
List submailbox. View All mailboxes from
virtual root submailbox
List virtual root mailbox. View Virtual Root Mailbox
List virtual root mailbox Execute MailboxLoginWithout
without mailbox execute VirtualRootPermission
permission.
Login if Access Control Execute Server Permission
List (ACL) is active.
Login to the virtual root Execute Virtual Root Mailbox
mailbox.

Login to the virtual root Execute MailboxLoginWithout
mailbox without mailbox VirtualRootPermission
execute permission.
Move message to Write Destination Mailbox
mailbox.
Remove message from Delete Mailbox
mailbox.
WebDAV Add message to mailbox. Write Mailbox
mailbox.
Get mailbox options. Execute Mailbox
Retrieve properties for View Mailbox
URL (PROFIND)
Edit a Mailbox Configuration

You can edit the description and permission assignment of an existing mailbox
under the Deployment menu.
About this task
To edit the description and permission assignment of an existing mailbox:
Procedure
2. Open the configuration data of the mailbox you want to edit using one of the
following methods:
v In the By Mailbox Name field of the Search section, type the name or partial
name of the mailbox you want to edit and click Go!
v In the Alphabetical section, select the letter the mailbox starts with or select
all to pull a list of all mailboxes and click Go!
3. A list of available mailboxes opens. Click the Edit button next to the mailbox
you want to edit.
4. In the Mailbox: Name page, change the Description field if necessary and click
Next. (This is a required field.)
Filter by Name field and click the filter button for a filtered list. No groups are
required.
6. In the Assign Users page, use the arrows to add users to the Selected Users list.
All users in the Selected Users list will have permissions on this mailbox. Click
the double arrow to add all available users to the Selected Users list.You can
type a partial user name in the Filter by ID field and click the filter button for
a filtered list and click Next. No users are required.
7. In the Confirm page, verify your mailbox configuration and click Finish.
Assign Mailbox Permissions

Permissions for individual mailboxes are assigned when you create the mailbox.
Mailbox 17
You can add mailbox permissions when you create a group or user account or you
can edit a group to add mailbox permissions after the mailbox is created.
Trading partners communicating using the Sterling Connect:Direct Server adapter

and FTP Server adapter must have a user account with Application, with the
appropriate permissions on mailboxes that they are trying to access.
Assign Mailbox Permissions to User Accounts

You can assign mailboxes to user accounts. You can do this at the time you create
the user account or you can edit a user account to add mailbox permissions.
Procedure
1. From the Accounts menu, select User Accounts. The Accounts page opens. You
can either create a new user account or edit an existing account, if necessary.
2. To create a new user account, in the Create section, next to Create a new
account, click Go!
3. Complete the fields in the User ID page, and click Next.
4. Complete the fields in the Groups page and click Next.
5. In the Permissions page, find the mailbox or mailboxes that you want to grant
permissions to in the Available list and move them to the Assigned list. Then
click Next.
6. When you are finished updating the user account, click Save or Finish.
Assign Mailbox Permissions to Groups

After you assign a group permissions to a mailbox, you can dynamically grant
permissions to new users by adding them to the group.
About this task
To add mailbox permissions to a group:
Procedure
1. From the Accounts menu, select Groups.
2. In the Assign Permissions page, search for the mailbox that you want to grant
permissions to.
3. When you are finished updating the group, click Save or Finish.
Assign Users to Mailbox Groups

There are two predefined mailbox groups, the Mailbox Browser Interface Users
group and the Mailbox Administrators group. All users that interact with
mailboxes through the MBI, must be added to the Mailbox Browser Interface Users
group. All users that administer mailboxes must be added to the Mailbox
Administrators group.
About this task
The Mailbox Administrators group has the Mailbox Browser Interface Users group
as a subgroup, so users do not need to be added to it separately. Following are
descriptions for each group:
v Mailbox Browser Interface Users Group - Users in this group have permissions
to access the Mailbox Browser Interface (MBI) business processes and templates.
External or internal trading partners that add files to and extract files from the
mailbox should be placed in this group.

v Mailbox Administrators Group - Users who are part of the Mailbox
Administrators group are also (automatically) part of the Mailbox Browser
Interface Users group. So making a user part of the Mailbox Administrators
group gives the user access to the Mailbox Browser Interface without the need to
assign the latter group, explicitly. The user ID Admin is, by default, part of the
Mailbox Administrators group.
To add users to these groups:
Procedure
1. From the Accounts menu, select User Accounts.
2. You can either create a new user account or edit an existing account.
3. To create a new user account, in the Create section, next to Create a new
account, click Go!
4. To edit an existing account, search by name or find it in a list. Click the edit
icon.
5. Complete the fields in the User ID page and click Next.
6. In the Groups page, move either the Mailbox Browser Interface Users group or
the Mailbox Administrators group from the Available list to the Assigned list
and click Next.
7. When you are finished updating the user account, click Save or Finish.
Edit an Exported Mailbox File

If you export a Mailbox, the XML file that is created contains the RIGHTS tag in
the Permissions section. You can edit the value of these rights.
About this task
To edit the value of the rights:
Procedure
1. Search for RIGHTS in the exported XML file.
2. Change the value according to the following settings:
v 1 - EXECUTE
v 2 - WRITE
v 4 - READ
v 8 = DELETE
v 16 = VIEW
3. Add the applicable values to determine the value to assign. For example, for
rights to read and write, the value is 2 + 4 = 6.
4. Import the edited file to activate the RIGHTS settings.
Create Virtual Roots

Virtual roots allow you to support limited visibility into the mailbox hierarchy,
mailboxes are visible to the end user as a relative path, while administrators see
the mailbox in an absolute or full path.
About this task
When a Mailbox Add service is invoked with a mailbox name, the mailbox name is
appended to the virtual root mailbox associated with the user ID to obtain the
Mailbox 19
absolute name of the mailbox to which the message should be added. The absolute
path to the mailbox is never disclosed to the sender.
When a Mailbox Query service is invoked, only mailboxes that are under the
virtual root of the user and for which the user has permissions can be searched.
This is useful for security reasons if you do not want to disclose the full path to a
mailbox. It is also valuable for mailbox maintenance. If you change the
organization of your mailbox, the virtual root does not change, so the change is
transparent to the user.
A trading partner using the new FTP Server adapter must have a virtual root
mailbox to have an FTP session.
To create a virtual root:
Procedure
1. From the Deployment menu, select Mailboxes > Virtual Roots.
3. Specify the User ID that you want to create the virtual root for and click Next.
You can type a partial user ID in the Filter by ID field and click the filter
button for a filtered list.
4. Specify the mailbox that you want to be the virtual root of the User ID and
click Next. You can type a partial mailbox name in the Filter by Name field
and click the filter button for a filtered list.
5. Click Finish.
Edit Virtual Roots

You can change the virtual root of a user ID. This does not impact any other
system resource and does not impact how the user interacts with the mailbox.
About this task
To change the virtual root of a user ID:
Procedure
1. From the Deployment menu, select Mailboxes > Virtual Roots.
2. Select the virtual root you want to edit using one of the following methods:
v In the By User ID field in the Search section, type the User ID that you want
to change the virtual root for and click Go!
v In the List section, select the first letter of the user ID, or select ALL for a list
of all virtual roots and click Go!
3. Identify the virtual root you want to edit and click edit in the Select column.
4. In the User ID page, click Next.
5. Select the Mailbox Name and click Next.
6. Click Finish.
Search for Messages

Mailbox enables you to search all mailboxes for messages. Criteria you can search
on include: mailbox, message name pattern, from date and time, to date and time,
processing status, and message ID.

About this task
Use the following procedure to perform a search:
Procedure
1. From the Deployment menu, select Mailboxes > Messages.
2. On the Message Management page, specify the criteria you want to search on
and click Go! The default for all fields is All. You can type a partial name of a
mailbox and click the filter button to filter by name and shorten the list.
3. A list of matching messages opens. The following table describes the content of
each column:
Column Title Description

Select Contains the icon for editing a message.
Name Message name. Displayed as hyperlink by default.
Note:
If the Extractable Count = 0, the hyperlink does not open the message.
To remove the hyperlink and display the message name as text, see
Display Message Name as Text.
ID Message ID assigned by the mailbox.
Created Date and time the message was created.
Size Size of the message in KB.
Mailbox Mailbox location of the message.
Extract Policy Extraction policy associated with the account.
Policy Value Value associated with the Extract Policy.
Locked by BP Indicates the business process that has the message locked, if any.
Display Message Name as Text

You can remove a hyperlink from a message name and display the name as text
only.
About this task

To remove the hyperlink from the message name and display the name as text
only:
Procedure
1. From the Deployment menu, select XSLT,
2. In the Search panel, enter MBIList and click Go!.
3. Click the source manager icon.
4. Click the edit icon to open the MBIlist file.
5. Enter a description for the change you are making.
6. Locate and remove the action element containing:
<a href=
/mailbox/mybp/FormToXML?bpDest=MBIDocView&MessageId={MessageId}&
amp;filename={MessageName}&bpresolverTimeout=360 target= _blank > </a>
After making your changes, click Next.
7. Select the version you modified, and click Save.
Mailbox 21
8. Review the information on the screen, verify the Enable for Business Process
check box is selected and click Finish.
9. Open the MBI and verify the Message Name link is disabled.
Suppress Duplicate Messages

Mailbox can suppress duplicate messages, providing a model similar to traditional
file systems.
About this task
In this mode, when a message is added to a mailbox, the system determines

whether a message with that same name is already present in the mailbox. If so,
then the old message is deleted before the new one is added. The document
associated with the old message is of course not deletedonly the message
referencing the document (content) is deleted. The document is still retrievable
through correlation search and archival search.
To suppress duplicate messages:
Procedure
1. Go to the installation folder > properties folder > mailbox.properties.in file.
2. Change the entry, disallowDuplicateMessages=false (default) to
disallowDuplicateMessages=true.
3. Run setupfiles.sh / .cmd.
4. Restart Application for changes to the mailbox.properties.in file to take effect.
Note: Message names are limited to 100 characters for DB2 on z/OS. All other
platforms support 255 character message names.
Allow Duplicate Messages in /DeadLetter

The FTP Server adapter places failed uploads in the DeadLetter mailbox.
About this task
To monitor failed uploads, you may wish to retain these duplicate messages, while
still disallowing duplicates in the rest of the system. The
disallowDeadLetterDuplicateMessages property in the mailbox.properties.in file
allows duplicates in the Deadletter mailbox only, overriding the mailbox-wide
property disallowDuplicateMessages.
To allow duplicate messages in the /Deadletter mailbox only:
Procedure
1. Use a text editor to edit the install_dir/properties/mailbox.properties.in
file. mailbox.properties.in file.
2. Set the value for the disallowDuplicateMessages property to true. Example:
disallowDuplicateMessages=true
Note: Retain the default value for the disallowDeadLetterDuplicateMessages

parameter. Example: disallowDeadLetterDuplicateMessages=false
3. Apply the configuration changes. Enter the appropriate command based upon
your operating system:
v setupfiles.sh (Unix)

v setupfiles.cmd (Windows)
4. Restart the application for changes to the mailbox.properties.in file to take
effect.
Update the Extractability of a Message

After a message is added to the mailbox, you can update the extractability policy
or policy value.
About this task
To update the extractability of a message:
Procedure
2. Specify the criteria you want to search on and click Go! The default for all
fields is All.
3. Identify the message that you want to change the extraction policy value and
click Edit. The Info page opens for the message.
4. Specify the new extract policy and policy value. The following table describes
the available policies and policy values:
Policy Description
Extractable Enables either unlimited extractions or no extractions.
Valid values are:

v No The message cannot be extracted.
v Yes No limit to how many times the file can be extracted.
Extractable Enables unlimited extractability until a certain date. This is ideal for
Until publishing time-sensitive documents such as price lists of catalogs.
Valid value is any future date.

Extractable Enables a message to be extracted a specific number of times. This policy
Count is ideal for automated processes that use a file a limited number of times.
This is the default policy.
Valid value is any integer. The default is 1.

Note:
If an IOException occurs during extraction, including a Cancel by the user,

a business process is initiated to increment the Extractable Count. For files
smaller than 100Kb, the entire file is already transmitted, so the business
process is not initiated. The Extractable Count must be manually
incremented for the message to be extractable again.
5. Click Finish.
Note: Extractability settings affect message visibility and extractability in

various ways for various communications protocols, such as, AS2, FTP,
Connect:Direct. For example, by default, the FTP Server adapter adds messages
with an extractable policy value of yes/no and an extractability value of yes.
This policy causes Mailbox to mimic a traditional file system. Messages added
through AS2 use an extractable policy value of N times with an extractability
value of 1. This policy supports transactional processing of AS2 messages. Be
aware of how users will access messages before changing policy settings.
Mailbox 23
Resubmit a Message for Automatic Routing
After a message is added to the mailbox, you can update the extractability policy
or policy value.
About this task
To resubmit a message for automatic routing:
Procedure
2. Specify the criteria you want to search on and click Go! The default for all
fields is All.
3. Identify the message that you want resubmit and click Edit. The Info page
opens for the message.
4. Select Resubmit message for automatic routing and click Next.
5. Click Finish.
Archive Messages
The application supports the archiving of mailbox messages as part of the overall
Application archiving process for business processes and documents.
Since mailbox messages are represented internally as business process documents,

there are certain precautions that Mailbox takes to protect messages from being
archived and inaccessible.
Mailbox messages and the business process responsible for executing the Mailbox
Add service are protected from archiving and remain in the Application database
tables until their corresponding mailbox message is deleted. They can be deleted
by the Mailbox Delete service or the Mailbox Scheduled Delete service. This
protection ensures that the message is available as long as it is needed. After a
message is deleted from a mailbox, the message is archived along with the
business process the next time an archive takes place when the configured archive
life span expires.
Restore Messages
After a business process and its associated message is archived, you can restore the
archive and audit the business process and associated message.
About this task
To restore the message:
Procedure
1. From the Operations menu, select Archive Manager.
2. In the Restore Manager section, click Go!
3. In the Command Line field, type the location for the restore_wrapper.sh script
and the location where the data is restored.
4. In the Working Directory field, specify the install_dir/bin directory, where
install_dir is the directory where Application is installed and click Go! This
restores all archived business processes. For processes that added or extracted
mailbox messages, the associated messages are restored with the business
process.

Search for Correlations to Business Processes
You can perform a correlation search to determine which business process accessed
a particular mailbox message. You can search on mailbox path, message ID,
message name, and creation date.
About this task
To search for correlations:
Procedure
1. From the Business Process menu, select Advanced Search > Correlation.
2. Depending on the search criteria you want to use, specify Any, All, or any
combination of the following and click Go!
Search Criteria Name Value

Mailbox path Mailbox_MailboxPath Mailbox ID of messages you want to
audit.
Message ID Mailbox_MessageID Message ID of message you want to
audit.
Message Name Mailbox_MessageName Name of the message you want to
audit.
Creation Date and Time Mailbox_CreateDateTime Creation date and time of the
message you want to audit.
The Correlation Search Results page opens, indicating the number of business
processes that matched. You can click the number identifying how many
business processes were found. The Multiple Document page opens with the
list of matched documents in the left pane.
3. In the Correlation Search page, from the Location list, select one of the
following options:
v Live Tables - Display correlations of live (active) instances.
v Archive Tables - Display correlations of instances that you have archived in.
v Restore Tables - Display correlations of instances that you have restored from
an offline location.
4. Click a document name to view the contents.
5. Click Info in the Status column to view document details.
Note: Correlation entries for mailbox events are truncated to 90 characters on

DB2 z/OS platforms. Message names in DB2 z/OS correlation entries have
trailing extra characters truncated, while MailboxPath correlation entries have
leading extra characters truncated.
Audit Restored Messages

After archived business processes are restored, you can audit the messages using
the central search feature. You can search for messages using the mailbox path,
message ID, message name, and creation date.
About this task
To audit restored messages:
Mailbox 25
Procedure
1. From the Business Process menu, select Monitor > Advanced Search >
Correlation.
2. In the Correlation Search page, specify Type as ANY and Location as Restore
Tables. Depending on the search criteria you want to use, specify Any, All, or
any combination of the following, and click Go!
Search Criteria Name Value

Mailbox path Mailbox_MailboxPath Mailbox ID of messages you want to
audit.
Message ID Mailbox_MessageID Message ID of message you want to
audit.
Message Name Mailbox_MessageName Name of the message you want to
audit.
Creation Date and Mailbox_CreateDateTime Creation date and time of the
Time message you want to audit.
The Correlation Search Results page opens, indicating the number of business
processes that matched.
3. Click the number identifying how many business processes were found. The
Multiple Document page opens with the list of matched documents in the left
pane.
4. Click a document name to view the contents.
Monitor EDIINT Activity

You can monitor AS2 EDIINT tracking for AS2 transfers that use Mailbox. This
information is only be available if AS2 is configured to use Mailbox.
About this task
Note: The EDIINT search function is only intended to track documents with
MDNs. Therefore, if an AS2 is configured not to request MDNs or if your partner
chooses not to recieve MDNs, the tracking information is not displayed in the
EDIINT search. The MDN is controlled by the sender, so if your partner does not
request it, you are unable to view that partners documents information using this
search.
Procedure
1. From the Business Process menu, select Advanced Search > EDIINT.
2. In the EDIINT Transaction Search page, specify the AS2 messages you want to
search for. Specify Any, All, or any combination of the following and click Go!
Search
Criteria Description
Contracts Search for AS2 transactions associated with a contract.
Status Search for AS2 transactions with a specific status.
Type Search for AS1 or AS2 transactions.
Start date Search for transactions according to the date the transfer started.
End date Search for transactions according to the date the transfer ended.
3. Click the message ID to view the details. The EDIINT Transaction Detail page
opens. The following fields are specific to Mailbox:
Field Description
Mailbox Mailbox associated with the transaction.
Mailbox Message ID assigned to the message.
Message ID
Mailbox Name of the message in the mailbox.
Message
Name
View Dead Letter Mailbox Contents and Status

The Dead Letter mailbox stores messages that could not be added to a regular
mailbox. The Dead Letter mailbox is located under the root mailbox as
/DeadLetter.
About this task
You can view information about messages using the following:

v View the contents of the Dead Letter mailbox.
v View the status report, including user ID of the message originator, the original
intended destination, and the reason for the failure. See Search for Correlations
to Business Processes.
Configure an AS2 Trading Partner to Use Mailbox

Mailbox provides ready-to-use integration with the EDIINT AS2 protocol.
About this task
This section describes how to configure your AS2 profile to use Mailbox. When
configuring your AS2 profile using the AS2 wizard, you encounter two fields that
you must select to use the mailbox.
To set up an AS2 trading partner to use Mailbox:
Procedure
1. From the Trading Partner menu, select AS2.
2. Start the AS2 wizard one of two ways:
v In the Create section, click Go! to create a new trading profile.
v To edit an existing trading profile, click Go! in the List section and click Edit
on the Profile.
3. In the New Identity: AS2 Configuration Type: Identification page, select Store
Messages in Mailbox.
4. In the AS2 Configuration Type Mailbox page, select one of the following
options:
v Use default Inbound/Outbound Mailboxes. Creates two mailboxes with the
format AS2/Name/Inbound and AS2/Name/Outbound, where Name is the
name given to the trading partner in the AS2 Configuration Type:
Identification page.
v Select Existing Parent Mailbox. Enables you to 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 (/). This creates two mailboxes with the format
Parent Mailbox/Inbound and Parent Mailbox/Outbound, where Parent Mailbox
is the mailbox you select to embed the mailbox you are creating.
Mailbox 27
All failed messages are placed in the /DeadLetter mailbox.
Troubleshoot AS2 Mailbox Issues after a System Failure

After a system failure of Sterling B2B Integrator AS2 Edition, producer messages
which did not get deleted from the producer mailbox need to be resolved.
About this task

Perform the following steps to resolve producer messages which did not get
deleted from the producer mailbox after a system failure. A system administrator
can resolve some cases without producer partner involvement, starting with step 1.
Otherwise, producer partners start at step 2.
Procedure
1. As the system administrator, determine if the message got routed.
a. Find the message ID of the files from Deployment > Mailboxes >
Messages.
b. Search in Sterling B2B Integrator AS2 Edition using advanced search by
Message ID.
c. If you find a result for the message ID, the message status should be
Failed. Replay the Arrived File. This enables you to resolve the issue
without producer partner involvement.
d. If you did not find a result for the message ID, contact the producer partner
and have the producer partner rename the file, with the instructions in Step
3.
2. As the producer partner, determine if the message got routed.
a. Log in to your producer mailbox and note the name of the message.
b. Search for the activity by Original File Name.
c. If you find a result for the original file name, it should have a status of
Failed. Replay the arrived file.
d. If you did not find a result for the original file name, go to step 3 and
rename the file.
3. As the producer partner, rename the message. Renaming causes the message to
be routed.
a. Log in as the producer partner user that added the file to Sterling B2B
Integrator AS2 Edition.
b. Navigate to the mailbox directory that contains your message.
c. Rename the message using the exact same file name. The rename command
varies for different protocols and clients. For example, the command line in
FTP and SFTP is the following:
rename filename filename
Determine AS2 Mailbox File Routing Status after a System

Failure
After a system failure of Sterling B2B Integrator AS2 Edition, some files may not
have been routed, and you need to confirm the status.
About this task
When a failover occurs, files may be in the following status:

v Routed

v Failed
v Routing
v Determining Routes
The producer files may have been processed, but may or may not be in mailboxes.
To identify the status of files, do the following:
Procedure
1. Select Business Processes > Monitor > Advanced Search > Business
Processes.
2. On the right side, under the section Search Using Business Processes, select
Business Processes, and then multiselect the following business processes:
v EDIINTParse
v HTTPAsyncSend
v HTTPSyncSend
v MailboxAS2Add
v MailboxAS2SendAndProcessAsyncMDN
v MailboxAS2SendAndProcessNoMDN
v MailboxAS2SendAndProcessSyncMDN
v MailboxAS2SendAsyncMDN
v MailboxAS2SendAsyncMDNSpawner
v MailboxAS2SendNoMDN
v MailboxAS2SendNoMDNSpawner
v MailboxAS2SendSyncMDN
v MailboxAS2SendSyncMDNSpawner
3. Select State > ALL.
4. Select Status > Error.
5. Select Start Date From and To for the time of interest and click Go.
6. The result is a list of the failed business processes. Click the ID of each failed
business process to obtain the details of the business process.
7. Navigate through the pages to get the details of the failed service.
8. Click the info link under the Instance Data column for the failed service to
obtain the instance data screen.
9. In the instance data screen, the current message indicates the iteration number
in the MessageId list above it. Count the iteration number from the message
list. This is the Message ID which you will use to determine the file.
10. Select Deployment > Mailboxes > Messages and enter the Message Id value
obtained in the previous step and click Go.
11. This returns the message name (the file) associated with the Message ID. Call
the producer partner who sent this file and ask them to re-send the file.
Attention: Ensure that all the messages which follow the failed message
have been correctly recovered. Check their status and recover as necessary.
Delete Mailboxes
The Mailbox Delete Mailbox service enables you to delete one or multiple
mailboxes, as well as the associated submailboxes, messages, virtual roots, routing
rules, and permissions.
Mailbox 29
About this task
The Mailbox Delete Mailbox service is designed to completely and permanently

remove mailboxes and everything associated with them. It differs in that it deletes
only messages in mailboxes.
You can either delete mailboxes interactively, through the Application interface, or
at a decision point in a business process, using the Mailbox Delete Mailbox service
in a business process.
To delete mailboxes interactively:
Procedure
1. Go to Deployment > Mailboxes > Configuration.
2. Next to List ALL, click Go!
3. Click the delete icon.
4. You have the option to view a report of what was deleted. You can also delete
mailboxes by using the Mailbox Delete Mailbox service.
Mailbox Browser Interface (MBI)
Configure the Mailbox Browser Interface (MBI)

The Mailbox Browser Interface (MBI) is a Web application that can reside inside
your secure network or in the DMZ of your company network.
About this task
To run the MBI inside your secure network, you must create an HTTP Server
adapter configuration (named MBI HTTP Server adapter) to enable clients on the
same network as the application to access the Mailbox Browser Interface.
To run the MBI in a DMZ, an HTTP Server adapter must be configured that uses a
remote perimeter server.
Incoming URL requests are passed from the HTTP Server adapter, which runs
preconfigured business processes. These business processes use a variety of
Mailbox services and return results to the browser that the original request came
from.
After a Perimeter Server has been configured in the application, its name is
available to the HTTP Server adapter configuration, in the Perimeter Server Name
list on the HTTP Connection Properties page.
To configure the MBI to run in the DMZ:
Procedure
1. Set up a perimeter server in the DMZ.
2. Configure a new Perimeter Server in the application.
The port specified in the Perimeter Server configuration must not be the HTTP
listen port (to which trading partners are expected to connect), which is
specified in a subsequent stage.
3. Ensure that the remote perimeter server is running.
4. Create an MBI HTTP Server adapter configuration.
a. From the Administration menu, select Deployment > Services >
Configuration.
b. In the Service Name field, enter HTTP Server and click Go!
c. On the Search Results page, find the entry that corresponds to the HTTP
Server adapter and click Copy.
d. Name the adapter MBI HTTP Server and click Next.
e. For the HTTP Listen Port, specify the port that the HTTP client (typically
the trading partner) is expected to connect to. This port must not be used
by a different application on the computer that the remote perimeter server
is installed on. No two HTTP Server adapter configurations can listen on
the same port on the same remote perimeter server computer.
f. From the Perimeter Server Name list, select the name of the Perimeter
Server (previously configured) that corresponds to the specific remote
perimeter server to be used. The name is in the format node & name, where
name is what you specified. Click Save.
g. On the Confirm page, verify that all parameters are as specified. Ensure the
Enable Service for Business Process check box is selected.
h. Click Finish.
5. If you have access to the computer on which the remote perimeter server is
running, log in to that computer and run the following command:
netstat -an | grep <httpListenPort>
where <httpListenPort> is the port previously specified. If a row is found that
reads LISTEN, the HTTP Server adapter is ready to handle requests from
external clients.
6. Verify that the HTTP Server adapter is listening and that the Mailbox Browser
Interface is configured correctly by pointing an HTTP browser to the following
URL:
http://<host>:<httpListenPort>/mailbox
where <host> is the IP address or host name of the computer where the remote
perimeter server is running and <httpListenPort> is the port previously
specified. A dialog opens, requesting the user name and password to use with
the Mailbox Browser Interface. If instead the browser encounters an error,
verify that <httpListenPort> is being listened on. If it is listening, verify that
some other application has not reserved this port. To do this, disable the HTTP
Server adapter and verify that this port is not being listened on. If it is, find the
application that has the port bound and shut it down. Alternately, select a
different HTTP Listen Port and try again.
Connect Trading Partners to the MBI

You can connect trading partners to the MBI through the Mailbox Browser
Interface Users group.
About this task
For your trading partners to use the MBI, perform the following:
Procedure
1. Create a new user account for each trading partner.
2. Assign trading partners to the Mailbox Browser Interface Users group.
3. Provide each trading partner the URL of your Web server.
Mailbox 31
v If your MBI application resides inside your secure network, use the following
URL:
http://<SIhost>:<MBIport>/mailbox
where <SIhost> is the IP address or host name of the computer where the
applications Web application is installed and <MBIport> is the port that the
MBI HTTP Server adapter listens on.
To find the <MBIport>, perform the following:
a. From the Administration menu, select Deployment > Services >
Configuration.
b. In the Service Name field, type MBI HTTP and click Go!.
c. On the Search Results page, find the entry that corresponds to the MBI
HTTP Server adapter and click the name of the adapter.
d. The HTTP Listen Port is the <MBIport>
v If you installed the MBI to run in the DMZ, use the following URL:
http://<host>:<httpListenPort>/mailbox
where <host> is the IP address or host name of the computer where the
remote perimeter server is running and httpListenPort is the port previously
specified. A dialog opens, requesting the user name and password to use
with the Mailbox Browser Interface. If instead the browser encounters an
error, verify that <httpListenPort> is being listened on. If it is listening, verify
that some other application has not reserved this port. To do this, disable the
HTTP Server adapter and verify that this port is not being listened on. If it
is, find the application that has the port bound and shut it down. Alternately,
select a different HTTP Listen Port and try again.
4. Provide each trading partner an initial user ID and password.
Note: Trading partners can obtain information about using the MBI by clicking
Help after logging in.
Change Your Password in the MBI

You can change your password under the Mailbox Browser Interface menu as an
external or internal user.
About this task

The application supports external authentication. If a user is set up as an external
user, then the password is stored in an external LDAP repository. In that case, the
application does not own the password, and cannot change it. For external users,
the Mailbox Browser Interface does not display the Change Password option.
To change your Mailbox password:
Procedure
1. From the Mailbox Browser Interface menu, select Change Password.
2. Type your old password in the Password field.
3. Type the new password in the New Password and Retype Password fields and
click Sign In.
Note: Your password must be at least six characters long and cannot contain
any of the following characters: ! @ # % ^ * ( ) + ? , ] [ { } | ; > < " &

Keep Permissions Secure in the MBI
This procedure ensures that each user has the correct permissions if multiple users
share a computer.
About this task
The following must be performed between user sessions:
Procedure
1. Log off from the application.
2. Clear the browser cache.
3. Close the browser session.
Search for Messages in a Mailbox

From the Search page, you can search for messages in any or all mailboxes that
you have permission to search.
About this task
The Search page is the first page that opens when you log in to Mailbox. The page
is also available from the navigation bar by clicking Search or Home.
To search a mailbox:
Procedure
1. From the Mailbox Browser Interface menu, select Mailbox Search.
2. Specify the criteria you want to search on as described in the following table:
Field Description
Mailbox Mailbox you want to search or select All to search all mailboxes you
have permission to search. Required.
To filter your search, use the MailboxPath lookup:

1. Type part of the path name in the Filter text box to reduce the size
of the list beneath it.
2. Click the path name you want and it populates the Mailbox field.
Message ID Message ID for your search.
Message Name Message name or partial message name for your search. You can use the
asterisk (*) as a wildcard.
From Beginning date and time range for your search.
Date format is yyyy-mm-dd. Time format is hh:mm:ss AM/PM.

To Ending date and time range for your search.
Date format is yyyy-mm-dd. Time format is hh:mm:ss AM/PM.
3. Click Go!. The Mailbox Search Results page displays with a listing of messages
found matching your criteria.
Note: You can sort the search results by clicking on any of the following
column headings: Name, ID, Created, Size, or Mailbox.
4. Determine action to perform on message:
Mailbox 33
v Click the message name to view the message in a browser window without
extracting the message.
v Click the Extract icon associated with a message to extract the message.
Search Results
From the Search Results page, you can sort the search results by clicking on any of
the following column headings: Name, ID, Created, Size, or Mailbox.
The Search Results page contains the following information:
Column Description
Extract Click to download the message (file) to your computer.
Name Name of the message. Click to view the message in a browser window.
ID Message ID assigned by the Mailbox.
Created Date and time the message was created.
Size Size of the message in bytes.
Mailbox Name of the mailbox containing the message.
Extract Policy Policy that is used to govern the extractability of the message:
v Count - Message is extractable a specific number of times (specified
in Policy Value column).
v Until - Messages are extractable until a specified date (specified in
the Policy Value column).
v Extractable - If Policy Value is Yes, the message is infinitely
extractable. If Policy Value is No, the message is not extractable.
Policy Value Identifies the values for the policy identified in Extract Policy.
Send a Message to a Mailbox

The Mailbox Browser Interface has a 2G size limit for files that you can send. To
send files that are larger than 2G, you can use myfilegateway.
Before you begin
Some browsers have additional file size limits that limit file transfers in
myfilegateway. If you do not have myfilegateway or if your browser does not support
large file transfers, you should use FTP or SFTP to send files larger than 2G.
About this task
To send a message to a mailbox:
Procedure
1. From the Mailbox Browser Interface menu, select Mailbox Send.
2. Specify the send criteria as described in the following table:
Field Description
Mailbox The Mailbox you want to send the message to. Required.
To filter your search, use the MailboxPath lookup:

1. Type part of the path name in the Filter text box to reduce the size
of the list beneath it.
2. Click the path name you want and it populates the Mailbox field.

Field Description
Filename The path and file name of the file you want to send.
Click Browse to navigate to the directory where the message is located.

Required.
The following characters cannot be used in the name: \ / : * ? " < > | %
!
Note: Message names are limited to 100 characters for DB2 on z/OS.
All other platforms support 255 character message names.
Rename File Use this option if you want to modify the name of the file or messsage.
The following characters cannot be used in the name: \ / : * ? " < > | %
!
3. Click Go!
If the file... then...

is successfully added, the Send page opens.
was not successfully added, an error message displays.
Note: When Mailbox Duplicate Suppression is turned on, an existing message

(with the same name as a new message) is removed, and a new message is
added. When Mailbox Duplicate Suppression is turned off, messages with the
same name can be added.
View a Message from a Mailbox Without Extracting

You can view a message from a mailbox without extracting it.
About this task
To view a message from a mailbox:
Procedure
Field Description
From Beginning date and time range for your search. Date format is
yyyy-mm-dd. Time format is hh:mm:ss AM/PM.
To Ending date and time range for your search. Date format is yyyy-mm-dd.
Time format is hh:mm:ss AM/PM.
3. Click Go!.
4. Identify the message you want to view and click the message name.
Mailbox 35
Extract a Message from a Mailbox
You can extract a message from a mailbox under the Mailbox Browser Interface
menu.
About this task
To extract a message from a mailbox:
Procedure
Field Description
From Beginning date and time range for your search. Date format is
yyyy-mm-dd. Time format is hh:mm:ss AM/PM.
To Ending date and time range for your search. Date format is yyyy-mm-dd.
Time format is hh:mm:ss AM/PM.
3. Click Go!.
4. Identify the message you want to extract and click the associated icon in the
Extract column.
Note: When you click the Extract icon, the Policy Value count is decreased by
one even if the download is cancelled.
If the message... then...

Is extractable, you are prompted to save the file.
Is not extractable, the extraction fails and an error message
displays. Click Back to return to the
previous page.
5. Click Refresh (on your Browser) to refresh the page and view the updated
extraction value.

Notices
This information was developed for products and services offered in the US. This
material might be available from IBM in other languages. However, you may be
required to own a copy of the product or product version in that language in order
to access it.
IBM may not offer the products, services, or features discussed in this document in
other countries. Consult your local IBM representative for information on the
products and services currently available in your area. Any reference to an IBM
product, program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product,
program, or service that does not infringe any IBM intellectual property right may
be used instead. However, it is the user's responsibility to evaluate and verify the
operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not grant you
any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing

IBM Corporation
North Castle Drive, MD-NC119
Armonk, NY 10504-1785
US
For license inquiries regarding double-byte character set (DBCS) information,

contact the IBM Intellectual Property Department in your country or send
inquiries, in writing, to:
Intellectual Property Licensing

Legal and Intellectual Property Law
IBM Japan Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japan
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS

PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of
express or implied warranties in certain transactions, therefore, this statement may
not apply to you.
This information could include technical inaccuracies or typographical errors.

Changes are periodically made to the information herein; these changes will be
incorporated in new editions of the publication. IBM may make improvements
and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.
Any references in this information to non-IBM websites are provided for

convenience only and do not in any manner serve as an endorsement of those
Copyright IBM Corp. 2000, 2015 37

websites. The materials at those websites are not part of the materials for this IBM
product and use of those websites is at your own risk.
IBM may use or distribute any of the information you provide in any way it
believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose
of enabling: (i) the exchange of information between independently created
programs and other programs (including this one) and (ii) the mutual use of the
information which has been exchanged, should contact:
IBM Director of Licensing

IBM Corporation
North Castle Drive, MD-NC119
Armonk, NY 10504-1785
US
Such information may be available, subject to appropriate terms and conditions,

including in some cases, payment of a fee.
The licensed program described in this document and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement or any equivalent agreement
between us.
The performance data and client examples cited are presented for illustrative
purposes only. Actual performance results may vary depending on specific
configurations and operating conditions.
Information concerning non-IBM products was obtained from the suppliers of

those products, their published announcements or other publicly available sources.
IBM has not tested those products and cannot confirm the accuracy of
performance, compatibility or any other claims related to non-IBMproducts.
Questions on the capabilities of non-IBM products should be addressed to the
suppliers of those products.
Statements regarding IBM's future direction or intent are subject to change or

withdrawal without notice, and represent goals and objectives only.
All IBM prices shown are IBM's suggested retail prices, are current and are subject
to change without notice. Dealer prices may vary.
This information is for planning purposes only. The information herein is subject to
change before the products described become available.
This information contains examples of data and reports used in daily business
operations. To illustrate them as completely as possible, the examples include the
names of individuals, companies, brands, and products. All of these names are
fictitious and any similarity to actual people or business enterprises is entirely
coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which

illustrate programming techniques on various operating platforms. You may copy,
modify, and distribute these sample programs in any form without payment to

IBM, for the purposes of developing, using, marketing or distributing application
programs conforming to the application programming interface for the operating
platform for which the sample programs are written. These examples have not
been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or
imply reliability, serviceability, or function of these programs. The sample
programs are provided "AS IS", without warranty of any kind. IBM shall not be
liable for any damages arising out of your use of the sample programs.
Each copy or any portion of these sample programs or any derivative work must
include a copyright notice as shown in the next column.
IBM 2015.
Portions of this code are derived from IBM Corp. Sample Programs.
Copyright IBM Corp. 2015.
Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of
International Business Machines Corp., registered in many jurisdictions worldwide.
Other product and service names might be trademarks of IBM or other companies.
A current list of IBM trademarks is available on the web at "Copyright and
trademark information" at www.ibm.com/legal/copytrade.shtml.
Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered
trademarks or trademarks of Adobe Systems Incorporated in the United States,
and/or other countries.
IT Infrastructure Library is a registered trademark of the Central Computer and

Telecommunications Agency which is now part of the Office of Government
Commerce.
Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo,
Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or
registered trademarks of Intel Corporation or its subsidiaries in the United States
and other countries.
Linux is a registered trademark of Linus Torvalds in the United States, other

countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of
Microsoft Corporation in the United States, other countries, or both.
ITIL is a registered trademark, and a registered community trademark of the Office

of Government Commerce, and is registered in the U.S. Patent and Trademark
Office.
UNIX is a registered trademark of The Open Group in the United States and other
countries.
Java and all Java-based trademarks and logos are trademarks or registered
trademarks of Oracle and/or its affiliates.
Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the

United States, other countries, or both and is used under license therefrom.
Notices 39
Linear Tape-Open, LTO, the LTO Logo, Ultrium and the Ultrium Logo are
trademarks of HP, IBM Corp. and Quantum in the U.S. and other countries.
Connect Control Center, Connect:Direct, Connect:Enterprise, Gentran,

Gentran:Basic, Gentran:Control, Gentran:Director, Gentran:Plus,
Gentran:Realtime, Gentran:Server, Gentran:Viewpoint, Sterling Commerce,
Sterling Information Broker, and Sterling Integrator are trademarks or registered
trademarks of Sterling Commerce, Inc., an IBM Company.
Other company, product, and service names may be trademarks or service marks
of others.
Terms and conditions for product documentation

Permissions for the use of these publications are granted subject to the following
terms and conditions.
Applicability
These terms and conditions are in addition to any terms of use for the IBM
website.
Personal use
You may reproduce these publications for your personal, noncommercial use
provided that all proprietary notices are preserved. You may not distribute, display
or make derivative work of these publications, or any portion thereof, without the
express consent of IBM.
Commercial use
You may reproduce, distribute and display these publications solely within your
enterprise provided that all proprietary notices are preserved. You may not make
derivative works of these publications, or reproduce, distribute or display these
publications or any portion thereof outside your enterprise, without the express
consent of IBM.
Rights
Except as expressly granted in this permission, no other permissions, licenses or

rights are granted, either express or implied, to the publications or any
information, data, software or other intellectual property contained therein.
IBM reserves the right to withdraw the permissions granted herein whenever, in its
discretion, the use of the publications is detrimental to its interest or, as
determined by IBM, the above instructions are not being properly followed.
You may not download, export or re-export this information except in full
compliance with all applicable laws and regulations, including all United States
export laws and regulations.
IBM MAKES NO GUARANTEE ABOUT THE CONTENT OF THESE

PUBLICATIONS. THE PUBLICATIONS ARE PROVIDED "AS-IS" AND WITHOUT
WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING
BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY,
NON-INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.

Notices 41
IBM
Product Number:
Printed in USA

SI52 Mailbox Book

Hochgeladen von

Dokumentinformationen

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

SI52 Mailbox Book

Hochgeladen von

Copyright:

Verfügbare Formate

Sterling B2B Integrator

Copyright IBM Corp. 2000, 2015 iii

Get Started with Mailbox

Quick Tour of Mailbox

Mailbox supports automated, scheduled, and manual processing of business

Copyright IBM Corp. 2000, 2015 1

A management user interface provides easy management of existing mailboxes and

Mailbox System Components

The system components and features of Mailbox are:

When necessary, Global permissions can be granted to other users and

2 Sterling B2B Integrator: Mailbox

The Mailbox Browser Interface is a Web system, and therefore requires

Integrate Mailboxes with an Application

Integrate Mailboxes with Services

In addition, Mailbox provides ready-to-use integration with the EDIINT AS2

You can integrate Mailbox with business processes by:

This system of the mailbox is useful where scheduled processing is

Mailbox Add Service

One of three extraction policies is assigned to a message when it is added to a

Mailbox Extraction Services

Mailbox Query Service

The Mailbox Query service supports multiple parameters, including:

Mailbox Delete Service

Mailbox Delete Mailbox Service

About this task

To delete mailboxes interactively:

Mailbox Scheduled Delete Service

For example, it is possible to create a configuration of the Mailbox Scheduled

6 Sterling B2B Integrator: Mailbox

Routing Rules for Mailboxes

Routing Rule Pattern and Action

Routing Rule Evaluation Modes

There are two routing rule evaluation modes-Automatic and Manual.

Adjust the Evaluation Frequency

About this task

Note: Frequency adjustment pertains only to the evaluation of automatic routing

To adjust the evaluation frequency:

Evaluate a Routing Rule at a Different Frequency

About this task

To evaluate a routing rule at a different frequency:

8 Sterling B2B Integrator: Mailbox

About this task

Use the following procedure to create a routing rule:

Edit a Routing Rule

Manually Evaluate a Routing Rule

About this task

To manually evaluate a routing rule:

10 Sterling B2B Integrator: Mailbox

Manage Your Mailbox

Organize Your Mailboxes

Example 1 - Message Name Suffix

The following figure represents a possible organization of mailboxes that uses

The following figure represents a possible organization of mailboxes that uses

Organize Information using the Mailbox Name

12 Sterling B2B Integrator: Mailbox

Organize Information using the Mailbox Path

In the example above, the mailbox path for Company A is:

Organize Information using the Message Name

The following are three examples:

Create a Mailbox and Assign Permissions

About this task

Create a Submailbox and Assign Permissions

About this task

Use the following procedure to create a submailbox: