The installation and configuration tasks for the e-Mail adapter depend on
the roles it must fill in the WebSphere business integration system.
Read the sections below to determine what tasks you must perform based on how
you will be using the e-Mail adapter.
- Note:
- If you are installing the e-Mail adapter as a stand alone system, see the
installation guides for further instructions, System Installation Guide
for Windows or the Implementation Guide for WebSphere MQ Integrator
Broker or the instructions in the section Comprehensive install and uninstall instructions for adapters.
If the adapter must poll for new e-Mail messages in an application and send
them to the integration broker for processing, perform the following
steps:
- Install the adapter as described in "Quick installation of the e-Mail adapter".
- Configure the mail server and mailboxes for poll locations. For
information, see "Configuring mail servers for polling".
- Create the business objects required to support the
interface. For more information, see Developing business objects for the adapter.
- Create or modify a meta-object for the data handler that the
adapter uses to process the data. For more information, see Data handler meta-objects.
- Create and configure a poll meta-object to contain a child
meta-object for each poll location. For more information, see Using e-Mail adapter meta-objects.
- Configure the mail servers that the adapter will be polling as described
in "Configuring mail servers for polling".
- Configure the adapter definition as described in Configuring the adapter definition. Keep the following points in mind:
- You must add the business objects developed for the interface in 3 as supported business objects for the adapter.
- You must add the poll meta-object created in 5 as a supported object for the adapter.
- You must add the data handler meta-object created in 4 as a supported object for the adapter.
- You must configure the properties of the adapter; because the adapter
will be polling, you must be sure to set the value of the PollConfigMO
property to the name of the poll meta-object created in 5.
- Run the adapter as described in "Running the adapter".
If the adapter must receive business objects from the integration broker
and process them, perform the following steps:
- Install the adapter as described in "Quick installation of the e-Mail adapter".
- Create the business objects required to support the interface. For
more information, see Developing business objects for the adapter. These business object will include a top-level
wrapper business object that contains routing information for the
adapter. For more information, see Using e-Mail adapter business objects.
- Create or modify a meta-object for the data handler that the adapter uses
to process the data. For more information, see Data handler meta-objects.
- Configure the adapter definition as described in Configuring the adapter definition. Keep the following points in mind:
- You must add the business objects developed for the interface in 3 as supported business objects for the adapter.
- You must add the data handler meta-object created in 4 as a supported object for the adapter.
- You must configure the properties of the adapter.
- Run the adapter as described in "Running the adapter".
- Note:
- Using the adapter for Error Notification (InterChange Server Integration
Broker Only)
If your integration broker is InterChange Server and the adapter will be
used for e-mail notification of errors, perform the following steps:
- The e-Mail adapter is automatically installed if your integration broker
is InterChange Server, for the reason that it plays such a significant role in
error notification, so you do not have to perform any installation
tasks. Proceed to configure the adapter properties as described in Configuring the adapter definition.
- Configure the Email Notification business object as described in EmailNotification business object.
- You must configure other InterChange Server components for e-mail
notification. For information on setting up e-mail notification of
errors, refer to the System Administration Guide.
- Run the adapter as described in Running the adapter.
