Registering an adapter to run as a Windows service

Whether your integration broker is InterChange Server or not, if you have a Windows environment, you can register the adapter to run as a Windows service. These sections describe how to do so

Registering a Windows service with InterChange Server as broker

When installing the adapter, check the Create Windows Service (IBM WebSphere InteChange Server) checkbox on the broker name screen. Installer will then perform the following tasks to register the adapter as a Windows service:

Installer then calls <install_location>\bin\cwservice.exe to register the adapter as a Windows service. Note that Installer does not start the service. After configuring the adapter, you can start the service by performing the following procedure:

  1. Choose Start>Settings>Control Panel>Administrative Tools>Services.
  2. Scroll to select CWConnector WBI<adaptername>Adapter.
  3. Click the arrow on the tool bar to start the adapter service.

Registering a Windows service with a non-ICS broker

To register an adapter as a Windows service with an integration broker other than InterChange Server, do the following:

  1. Install Adapter Framework 2.6
  2. Apply Adapter Framework Fix Pack 2.6.0.3.
  3. Install the adapter.
  4. Locate the file
    <installation_location>\connectors\<adapter_name>\reg_<adaptername>.bat
  5. Log in as admin and launch this batch file from the command line:
    reg_<adaptername>.bat <path to config file> <optional dependent service>

where the <path_to_config_file> is the fully qualified path to the adapter configuration file and <optional_dependent_service> is any depdendent service that the adapter service requires. Separate multiple dependent services with commas. Globalized messages will display any errors associated with invalid input parameters to this utility. When you successfully install your adapter, Installer places the utility reg_<adaptername>.bat in the directory <install_location>\connectors\<adaptername>.

Installer replaces the following fields in the bat file:

To confirm that the adapter is running as a Windows service, perform the following tasks:

  1. Choose Start>Settings>Control Panel>Administrative Tools>Services.
  2. Scroll to CWConnector WBI<adaptername>Adapter.
  3. If the service has not started, select the service and click the arrow on the tool bar to start the adapter service.

Copyright IBM Corporation 2003, 2005. All Rights Reserved.