Installing the adapter

Note:
Before installing the adapter, be certain that you have installed WebSphere MQ and that an WebSphere MQ listener has been created and is running. If you are using a two-machine topology with two queue managers, a listener must be running for the queue manager on each machine. To determine that the listener is running, open the WebSphere MQ Services console window, and expand the folder icon for your queue manager. The listener icon in the description panel should show a status of Running. If it does not, consult your WebSphere MQ documentation or online help for information about starting the listener.

The installation process consists of the following tasks:

Installing the files

To add the adapter files to your existing ICS installation, execute the Installer utility (setupwin32.exe on Windows, setupAIX.bin or setupsolarisSparc.bin on UNIX) provided in your delivery package. The Installer utility installs standard files associated with the adapter, as described below.

Windows adapter file structure

The Installer utility copies the standard files associated with the adapter into your system.

The utility allows you to browse and select the directory into which it will install the adapter subdirectories and files. You must install to the product directory that you used for your installation of the IBM WebSphere ICS. Use the browse button in the Installer to locate the directory and select it.

Table 7 describes the Windows file structure used by the adapter, and shows the files that are automatically installed when you install the adapter through Installer.

Table 7. Installed Windows file structure for the adapter
Subdirectory of ProductDir Description
connectors\WebSphereCommerce\CWWebSphereCommerce.jar

Contains classes of the WebSphereCommerce adapter only

connectors\WebSphereCommerce\CWJMSCommon.jar

Contains JMS classes shared by this adapter and other WebSphere MQ-based adapters

connectors\WebSphereCommerce\start_WebSphereCommerceAdapter.bat

The startup script for the adapter (NT/2000)

connectors\messages\WebSphereCommerce.txt

Message file for the adapter

repository\WebSphereCommerce\CN_WebSphere_Commerce.txt

Repository definition for the adapter

connectors\WebSphereCommerce\utilities\alter_qmanager.mqsc

Script to alter the CCSID of the queue manager

connectors\WebSphereCommerce\utilities\define_WCAdapter_queues.mqsc

Creates a sample set of a queue manager and queues for the adapter in a single-machine topology

connectors\WebSphereCommerce\utilities\ConfigureAdapterQueues.bat

Batch file that executes the MQ configuration scripts

connectors\WebSphereCommerce\samples\MO_WebSphereCommerceConfig.in

A sample definition of a meta-object in the repository

connectors\WebSphereCommerce\samples\Readme.txt

Instructions for running a sample scenario that uses the sample files provided

connectors\WebSphereCommerce\samples\Sample_CusCre.BO

Sample Customer business object

connectors\WebSphereCommerce\samples\WC_BODefinition.in

Sample business object definition file

connectors\WebSphereCommerce\samples\WC_CollabObj.in

Sample collaboration definition file

connectors\WebSphereCommerce\samples\WC_CollabTemplate.in

Sample collaboration template

connectors\WebSphereCommerce\samples\WC_PortConnector.in

Sample Port connector definition file

connectors\WebSphereCommerce\samples\collaborationclasses\ CreCustTemplate.class

Class file for sample Create_Customer collaboration templates

connectors\WebSphereCommerce\samples\collaborationclasses\ CrePurchOrdTemplate.class

Class file for sample Create_Purchase_Order collaboration templates

connectors\WebSphereCommerce\samples\collaborationclasses\ ReqProdInvTemplate.class

Class file for sample Request_Product_Inventory collaboration templates

Note:
All product pathnames are relative to the directory where the product is installed on your system.

UNIX adapter file structure

The Installer copies the standard files associated with the adapter into your system.

The utility allows you to browse and select the directory into which it will install the adapter subdirectories and files. You must install to the product directory that you used for your installation of the IBM WebSphere business integration system. Use the browse button in the Installer to locate the directory and select it.

Table 8 describes the UNIX file structure used by the adapter, and shows the files that are automatically installed when you choose to install the adapter through Installer.

Table 8. Installed UNIX file structure for the adapter
Subdirectory of ProductDir Description

connectors/WebSphereCommerce/CWWebSphereCommerce.jar

Contains classes used by the WebSphereCommerce adapter only

connectors/WebSphereCommerce/CWJMSCommon.jar

Contains classes shared by this adapter and other WebSphere MQ-based adapters

connectors/WebSphereCommerce/start_WebSphereCommerceAdapter.sh

System startup script for the connector. This script is called from the generic adapter manager script. When you click the Connector Configuration screen of CSM, the installer creates a customized wrapper for this adapter manager script. Use this customized wrapper to start and stop the connector.

connectors/messages/WebSphereCommerce.txt

Message file for the adapter

repository/WebSphereCommerce/CN_WebSphereCommerce.txt

Repository definition for the adapter

Note:
All product pathnames are relative to the directory where the product is installed on your system.

Loading files into the repository

Use the repos_copy command to load the components--connector definition and meta-objects--required for the adapter.

Procedures for using the repos_copy command are in the IBM WebSphere Business Integration Adapters System Administration Guide.

Copyright IBM Corp. 1997, 2003