Configuring e-mail notification of log messages

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:

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.

Steps for configuring e-mail notification at the system level

Perform the following steps to configure e-mail notification at the system level:

  1. Open System Manager
  2. 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.

  3. 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


  4. Select an e-mail type from the E-mail send type list:
  5. Type one or more valid e-mail addresses in each subsystem field. The address must be SMTP-compliant.
  6. In System Manager, click File > Save ServerName. The system-level e-mail notification information you entered is saved in the InterchangeSystem.cfg file.
  7. 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:

  8. Additional step if you configured Connector mail: Configure the e-Mail connector.

    Do the following:

Steps for configuring e-mail notification at the collaboration object level

Perform the following steps to set an e-mail address to receive messages for a collaboration:

  1. 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.

  2. In the Collaboration General Properties tab, type a valid e-mail address in the Email notification address field. The address must be SMTP-compliant.
  3. Click OK to save your changes and close the window.
  4. Restart the collaboration for changes to take effect.

Steps for configuring e-mail notification at the connector level

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:

  1. 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.

  2. 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.
  3. Click File > Save > To Project.
  4. Close the Connector Configurator Express window.
  5. Restart the connector for the change to take effect.

Copyright IBM Corp. 2004