- Important:
- As noted earlier in this chapter, the connector, business
objects, the data handler meta-objects, and collaborations must be
configured after installation and before starting the connector to
assure proper operation. For a summary of these tasks, see Overview of configuration tasks. In
addition, connector polling should not be disabled (connector
polling is enabled by default).
A 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. The name of the
startup script depends on the operating-system platform, as
Table 3 shows.
Table 3.
Startup scripts for a connector
Operating
system |
Startup
script |
UNIX-based
systems |
connector_manager_connName |
Windows |
start_connName.bat |
You can invoke the connector startup script in any of the
following ways:
- On Windows systems, 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
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.
- On Windows systems, you can configure the connector to start as
a Windows service. In this case, the connector starts when the
Windows system boots (for an Auto service) or when you start the
service through the Windows Services window (for a Manual
service).
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.
