- Important:
- As noted earlier in this chapter, the connector, business objects, the SOAP
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. On Windows systems the startup script should reside in
the connector's runtime directory:
ProductDir\connectors\connName
where connName identifies the connector.
On UNIX systems the startup script should reside in the
ProductDir/bin directory.
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
|
Windows
| start_connName.bat
|
When the startup script runs, it expects by default to find the
configuration file in the Productdir (see the commands
below). This is where you place your configuration file.
- Note:
- You need a local configuration file if the adapter is using JMS
transport.
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 (available only when the broker is WebSphere
Application Server or InterChange Server), which is launched when you start
System Manager
You can load, activate, deactivate, pause, shutdown or delete a connector
using this tool.
- From System Manager (available for all brokers)
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.
