Starting the connector
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\tcpip.
On Linux systems the startup script should reside in the ProductDir/bin
directory.
On i5/OS systems the startup script should reside in the /QIBM/UserData/WBIServer44/<instance>/connectors/<ConnInstance>/ with which the connector runs.
The name of the startup script depends on the operating-system
platform, as Table 5 shows.
Table 5. Startup scripts for a connector
Operating system |
Startup script |
Linux |
connector_manager |
i5/OS |
start_tcpip.sh |
Windows |
start_tcpip.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.
-
Starting the connector on a Windows system:
- From the Start menu, select Programs>IBM WebSphere Business Integration Express>Adapters>Connectors.
By default, the program name is "IBM WebSphere Business Integration
Server Express." However, it can be customized. Alternatively,
you can create a desktop shortcut to your connector.
- From the Windows command line: start_connName connName brokerName
{-cconfigFile}.
- 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).
-
Starting the connector on a Linux system:
- Starting the connector on an i5/OS system:
- From the Windows system where the WebSphere Business Integrations
Server Express Console is installed, select IBM WebSphere Business Integration Server Express>Toolset Express>
Administrative>Console. Then specify the
i5/OS system name or IP address and a user profile and password
that has *JOBCTL special authority. Select the connector from the
list of connectors, and click Start
- To automatically start the adapter using the Console, use the
submit_adapter.sh script. You can also set the adapter agent from
the Console to start automatically. To set the option, right-click
on the adapter agent and click to enable the Autostart check
box.
- In Batch mode, from the i5/OS command line, you need to run
the CL command QSH and from the QSHELL environment. Run /QIBM/ProdData/WBIServer44/bin/submit_adapter.sh connName WebSphereICSName pathToConnNameStartScript jobDescriptionName,
where connName is the connector name, WebSphereICSName is
the Interchange Server Express server name (default is QWBIDFT44), pathToConnNameStartScript is
the full path to the connector start script, jobDescriptionName is
the name of the job description to use in the QWBISVR44 library.
- In interactive mode, specify:
connector_manager -start connName WebSphereICSName [-cconfigFile]. For InterChange
Server Express, for WebSphereICSName specify the name of the InterChange
Server Express instance.
For more information on how to start a connector, including the
command-line startup options, refer to the System Administration Guide.
Tasks performed during connector startup
When the connector is started, it performs the following
tasks:
- Retrieves configuration information
- Retrieves the supported internal business object definitions
- Returns the connector version
- Returns a pointer to the internal business object handler
- Retrieves a pointer to the data handler
