Error and fatal messages that are logged to the InterChange Server Express
log can also be sent to the InterChange Server Express system administrator,
or any other recipient, by e-mail. By default, InterChange Server
Express is configured to send e-mail notifications using JavaMail, but you can
configure the server to send e-mail notifications using the e-Mail
connector. For instructions on configuring e-mail notification using
the e-Mail connector, refer to Steps for configuring e-mail notification at the system level.
- Note:
- If you want to configure collaborations for e-mail notification, you must use
the e-Mail connector.
The following components can be configured for sending error and fatal
messages to an e-mail recipient:
- InterChange Server Express
- Collaboration objects
- Connectors
You can configure e-mail notification at the system level (set in the
InterchangeSystem.cfg file), at the collaboration object
level (set as a collaboration object property), or at the connector level (set
as a connector property). If you configure e-mail notification at the
system level, the configuration applies to all of the collaboration objects or
connectors in the system. If you configure e-mail notification at the
collaboration object or connector level, the configuration applies only to
that specific component and supersedes the system configuration.
E-mail notification in the InterChange Server Express system supports
Simple Mail Transport Protocol (SMTP) mail messages, therefore, the e-mail
recipient value in the InterchangeSystem.cfg file and the
collaboration e-mail addresses must be standard Internet addresses.
A valid e-mail address entry can be one or more fully qualified Internet
addresses, separated by commas. For example, a valid entry for two
recipients is:
JohnDoe@company.com,FredSmith@company.com
You cannot use personal address aliases, such as an alias defined in a
personal address book. However, a valid address can be an alias defined
in a mail server, such as Eng@company.com. In this
case, the mail server decodes the alias and sends e-mail to all members of the
alias. For example, a decoded alias might be
person1@some_company.com,
person2@another_company.com, and so forth.
Perform the following steps to configure e-mail notification at the system
level:
- Open System Manager
- In the InterChange Server Component Management view, right-click the
server and click Edit Configuration.
The upper-right section of the System Manager window becomes a tool in
which you can edit the InterchangeSystem.cfg file.
- Click the E-mail tab.
A dialog box appears in the upper-right section of the System Manager
window in which you can enter the parameters necessary for configuring e-mail
notification at the system level (see Figure 49).
Figure 49. Edit Configuration, E-mail tab

- Select an e-mail type from the E-mail send type list:
- Select Java mail if you do not plan to configure collaborations
for e-mail notification. An SMTP mail host field appears at
the top of the list of subsystems. Type the host name of the SMTP mail
server.
- Note:
- Be sure to use the correct case, as this field is case sensitive.
- Select Connector mail if you plan to configure collaborations
for e-mail notification. If you use this type of e-mail you must
install the e-Mail connector, then configure the e-Mail connector and e-Mail
business object. For instructions on installing the e-Mail connector,
see WebSphere Business Integration Server Express Installation
Guide. For instructions on configuring the e-Mail connector and
e-Mail business object, see steps 7 and 8.
- Type one or more valid e-mail addresses in each subsystem field.
The address must be SMTP-compliant.
- In System Manager, click File > Save
ServerName. The system-level e-mail notification
information you entered is saved in the
InterchangeSystem.cfg file.
- Additional step if you configured Connector mail:
Configure the EmailNotification business object to hold the e-mail address of
the person who receives e-mail if the intended e-mail recipient is
unreachable. As a fail-safe, this should probably be the mail
administrator, not the InterChange Server Express system administrator, to
ensure the mail is delivered if the InterChange Server Express system
administrator is unreachable.
Do the following:
- In System Manager, right-click the EmailNotification business object, and
click Edit definition. The EmailNotification Business Object
Designer Express window appears.
- On the Attributes tab, type the return e-mail address in the
Default column of the FromAddress attribute.
- Click File > Save.
- Close Business Object Designer Express.
- Additional step if you configured Connector mail:
Configure the e-Mail connector.
Do the following:
- In System Manager, double-click the EmailConnector object. The
Connector Configurator Express window appears.
- On the Connector Specific Properties tab, double-click the
Value cell for the SMTP_MailHost property, then type the
name of the Simple Mail Transport Protocol (SMTP) host in the text
field.
- Click File > Save > To Project.
- Close Connector Configurator Express.
Perform the following steps to set an e-mail address to receive messages
for a collaboration:
- In System Manager, go to the InterChange Server Component Management view,
right-click the collaboration object for which you want to configure e-mail
notification, and click Properties.
The Properties dialog box appears.
- In the Collaboration General Properties tab, type a valid
e-mail address in the Email notification address field. The
address must be SMTP-compliant.
- Click OK to save your changes and close the window.
- Restart the collaboration for changes to take effect.
You can configure e-mail notification for a specific connector, however,
configuration parameters set at the collaboration object level supersede those
set at the system level.
Perform the following steps to configure e-mail notification for a specific
connector:
- In System Manager, right-click the connector for which you want to
configure e-mail notification, and click Edit Definition.
The Connector Configurator Express window appears.
- In the Standard Properties tab, select true in the
Value field of the LogAtInterchangeEnd property.
This enables connector messages to be mailed to the InterChange Server Express
log.
- Click File > Save > To Project.
- Close the Connector Configurator Express window.
- Restart the connector for the change to take effect.
