To start the adapter for Exchange Server, you must:
- Start the connector.
- Start Event Listener.
The connector can be explicitly started using its connector start-up
script. The startup script should reside in the connector's
runtime directory:
For Windows:
ProductDir\connectors\connName
or
For UNIX:
ProductDir/connectors/connName
where connName identifies the connector, and
ProductDir is the directory in which you installed the
product. For a connector running under Windows, this file is
ProductDir\connectors\Exchange\start_Exchange.bat.
For a connector running under UNIX, this file is
ProductDir/connectors/Exchange/start_Exchange.sh.
You can invoke the connector startup script in any of the following
ways:
- In Windows, 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. You can also create a desktop shortcut to your
connector.
- In Windows, from the command line, accessing the appropriate
directory:
start_connName connName brokerName [-cconfigFile ]
where connName identifies your 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.
- In UNIX, from the command line, accessing the appropriate directory
connector_manager -start Exchange [-cconfigFile]
- 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.
- In Windows only, the connector can be run as a Windows service. For
more information, refer to Installation Guide for WebSphere Business
Integration Adapters.
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.
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
- Builds a business object for any subscribed event found during startup
By default, Event Listener is started automatically by the Information
Service when the trigger (the arrival of a registered event) occurs. If
you need to start 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.
