Installed file structure

The sections below describe the paths and filenames of the product after installation.

Note:
WebSphere MQ and JMS typically are installed in separate directories.

On Windows, WebSphere MQ is generally installed under \Program Files\IBM\WebSphere MQ and JMS under \Program Files\IBM\WebSphere MQ\Java\lib. Update your classpath accordingly in the WebSphere MQ connector startup script.

On Linux, WebSphere MQ is installed under /opt/mqm and JMS support under /opt/mqm/java/lib.

On OS400, WebSphere MQ is installed in the directory /QIBM/ProdData/mqm. The JMS support is installed in /QIBM/ProdData/mqm/java/lib.

Windows file structure

The Installer copies the standard files associated with the connector into your system. The utility installs the connector into the ProductDir\connectors\WebSphereMQ directory. Note that ProductDir represents the directory where the WebSphere Business Integration Server Express is installed. The environment variable contains the ProductDir directory path, which is IBM\WebSphereServer by default.

Table 1 describes the Windows file structure used by the connector, and shows the files that are automatically installed when you choose to install the connector through Installer.

Table 1. Installed file structure for the WebSphere MQ connector (Windows)

Subdirectory of ProductDir Description
connectors\WebSphereMQ Contains the following files:
  • CWWebSphereMQ.jar--Classes used by the WebSphere MQ connector
  • start_WebSphereMQ.bat--The startup script for the connector
  • start_WebSphereMQ_service.bat--The startup script for starting the connector as a Windows service.
  • ReadMe.htm--Patch Notes for the adapter.
connectors\messages Contains the WebSphereMQConnector.txt message file, as well as the WebSphereMQConnector_ll_TT.txt files (message files specific to a language (ll) and a country or territory (TT)).
repository\WebSphereMQ Contains the CN_WebSphereMQ.txt repository definition for the connector.
connectors\WebSphereMQ\samples Contains the sample artifacts.
lib Contains the WBIA.jar file.
bin Contains the CWConnEnv.bat file.

The Installer adds an icon for the connector to the Start menu (available by clicking Start ->Programs -> IBM WebSphere Business Integration Express -> Adapters -> Connectors). For a fast way to start the connector, create a shortcut to this file on the desktop.

OS/400 file structure

By default, the adapter is installed in the /QIBM/ProdData/WBIServer43/product directory (referred to as ProductDir). Table 2 describes the OS/400 file structure used by the connector, and shows the files that are installed during a typical installation.

Table 2. Installed file structure for the WebSphere MQ connector (OS/400)

Subdirectory of ProductDir Description
connectors/WebSphereMQ Contains the CWWebSphereMQ.jar file and the start_WebSphereMQ.sh startup script.
connectors/messages Contains the WebSphereMQConnector.txt message file, as well as the WebSphereMQConnector_ll_TT.txt files (message files specific to a language (ll) and a country or territory (TT)).
repository/WebSphereMQ Contains the CN_WebSphereMQ.txt repository definition for the connector.
connectors/WebSphereMQ/samples Contains the sample artifacts.
lib Contains the WBIA.jar file.
bin Contains the CWConnEnv.sh file.

You can quickly start the connector with the WebSphere Business Integration Console function. For more information, refer to the online help provided with the Console.

Linux file structure

By default, the standard files associated with the connectors are installed into the ProductDir/connectors/WebSphereMQConnector directory. Note that ProductDir represents the directory where WebSphere Business Integration Server Express is installed(by default, /home/${username}/IBM/WebSphereServer).

Table 3 describes the Linux file structure used by the connector, and shows the files that are automatically installed during a typical installation.

Table 3. Installed file structure for the WebSphere MQ connector (Linux)

Subdirectory of ProductDir Description
connectors/WebSphereMQ Contains the CWWebSphereMQ.jar file and the start_WebSphereMQ.sh startup script.

The start_WebSphereMQ.sh startup script is called from the generic connector manager script (the connector_manager -start script located in the ProductDir/bin directory).

connectors/messages Contains the WebSphereMQConnector.txt message file, as well as the WebSphereMQConnector_ll_TT.txt files (message files specific to a language (ll) and a country or territory (TT)).
repository/WebSphereMQ Contains the CN_WebSphereMQ.txt repository definition for the connector.
connectors/WebSphereMQ/samples Contains the sample artifacts.


lib Contains the WBIA.jar file.
bin Contains the CWConnEnv.sh file.

You must use the connector_manager command to start the connector on a Linux system.

Copyright IBM Corp. 2004