Determining installation and configuration tasks
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 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.
Using
the adapter for event notification
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 Installing
the e-Mail adapter and related files.
- 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 Starting
the connector.
Using the adapter for business
object processing
If the adapter must receive business objects from the
integration broker and process them, perform the following steps:
- Install the adapter as described in Installing
the e-Mail adapter and related files.
- 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 Starting
the connector.
Using
the adapter for error notification
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 Starting
the connector.
