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\connNamewhere
connName identifies the connector.
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 7 shows.
Table 7. Startup scripts for a connector
Operating system
| Startup script
|
Linux-based systems
| connector_manager
|
i5/OS
| start_connName.sh
|
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.
Starting the connector on a Windows system:
- From the Start menu, select Programs>IBM WebSphere
Business Integration Server 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-based systems:
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 OS/400 or 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. This is the only way the adapter will
start using the subsystem within the autostart job entry for the
server.
- 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 QWIBDFT44),
pathToConnNameStartScript is the full path to the connector start
script, jobDescriptionName is the name of the job description to
use in the QWIBSVR44 library.
- In interactive mode, you need to run the CL command QSH and from the
QSHELL environment. Run
/QIBM/UserData/WBIServer44/WebSphereICSName/connectors/connName/
start_connName.sh connNameWebsphereICSName [-cConfigFile] where
connName is the name of your connector and
WebSphereICSName is 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.
