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\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 18 shows.
Table 18. Startup scripts for a connector
Operating system |
Startup script |
Linux |
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 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 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 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, 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.
