Starting the adapter
To start the adapter for Exchange Server, you must:
- Start the connector.
- Start Event Listener.
Starting the connector
Startup script and methods
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
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.
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 Server Express Adapters>Adapters>Connectors.
By default, the program name is "IBM WebSphere Business Integration Server Express 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 InterChange Server Express, specify for brokerName the name of the InterChange Server Express 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 InterChange Server Express, 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 (InterChange Server Express 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 WebSphere Business Integration Server Express Installation Guide for Windows.
For more information on how to start a connector, including the
command-line startup options for InterChange Server Express, refer
to the System Administration Guide.
Tasks performed during connector startup
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
Starting Event Listener
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.
