To start the adapter for Exchange Server, you must:
- Start the connector.
- Start the Event Listener.
The connector must be explicitly started using its connector
start-up script. The startup script should reside in the
connector's runtime directory:
ProductDir\connectors\connName
where connName identifies the connector, and
ProductDir is the directory in which you installed the
product. For the Exchange adapter, this file is
ProductDir\connectors\Exchange\start_Exchange.bat.
You can invoke the connector startup script in any of the
following ways:
- From the Start menu
Select Programs>IBM WebSphere Business Integration
Adapters>Adapters>Connectors. By default, the program
name is "IBM WebSphere Business Integration Adapters". However, it
can be customized. Alternatively, you can create a desktop shortcut
to your connector.
- From the command line
- start_connName connName brokerName
[-cconfigFile ]
where connName is the name of the connector and
brokerName identifies your integration broker, as
follows:
- For WebSphere InterChange Server, specify for brokerName
the name of the ICS instance.
- For WebSphere message brokers (WebSphere MQ Integrator,
WebSphere MQ Integrator Broker, or WebSphere Business Integration
Message Broker) or WebSphere Application Server, specify for
brokerName a string that identifies the broker.
- Note:
- For a WebSphere message broker or WebSphere Application Server
on a Windows system, you must include the -c option
followed by the name of the connector configuration file. For ICS,
the -c is optional.
- From Adapter Monitor (WebSphere Business Integration Adapters
product only), which is launched when you start System Manager
You can load, activate, deactivate, pause, shutdown or delete a
connector using this tool.
- From System Monitor (WebSphere InterChange Server product only)
You can load, activate, deactivate, pause, shutdown or delete a
connector using this tool.
- Note:
- Some WebSphere Business Integration adapters can be run as a
Windows service. However, the adapter for Exchange must be started
from a command prompt. It cannot be started as a Windows service.
It can be started as a Windows task.
For more information on how to start a connector, including the
command-line startup options, refer to one of the following
documents:
- For WebSphere InterChange Server, refer to the System
Administration Guide.
- For WebSphere message brokers, refer to Implementing
Adapters with WebSphere Message Brokers.
- For WebSphere Application Server, refer to Implementing
Adapters with WebSphere Application Server.
Note that the connector logs onto the Exchange Server with a
MAPI profile that must already exist on the machine where the
connector is started. This profile directs the Outlook client to
the name of the appropriate mailbox. If the user who starts the
connector does not have access to this mailbox, the system prompts
the user for a login name and password.
When the connector is started, it performs the following
tasks:
- Retrieves configuration information
- Logs on to Exchange Server with the retrieved configuration
information
- Retrieves the supported business object definitions
- Retrieves a list of event subscriptions the connector
supports
- Returns the connector version
- Returns a pointer to the business object handler
- Optionally, polls the event store based on priorities
- Builds a business object for any subscribed event found during
startup
By default, the Event Listener is started automatically by the
Information Service when the trigger (the arrival of a registered
event) occurs. If you need to start the Event Listener manually,
however, use the Windows Component Services Administrative Tool, as
follows:
- Click Start --> Programs --> Administrative Tools
--> Component Services. The Component Services dialog box
opens.
- Expand the Component Services and COM+ Applications
folders.
- Right-click the BIA_Exchange application in the COM+
Applications folder to bring up the context menu, then click
Start.
