WebSphere MQ and PL/I installation and usage notes

To verify a WebSphere MQ installation version, open a command prompt and change the directory to the root directory for the MQ install. Then type dspmqver and press Enter.

WebSphere MQ version information similar to the following displays:

Name:        WebSphere MQ
Version:     7.0.1.3
CMVC level:  p701-103-100818
BuildType:   IKAP - (Production)

When installing on Windows 7 environments, you may see a message similar to this when running the installer:

Your operating system is currently unsupported. Continuing WebSphere MQ 7.0 installation is not recommended.

Even after clicking OK, the WebSphere MQ Version 7 Software requirements page may indicate an error, and that the WebSphere MQ Eclipse Platform version 3.3 software was not installed.

Perform the following steps to address this issue.

Use Windows Explorer to navigate to the location of the WebSphere MQ installer executable. This path typically ends with \MQSx.x (where x.x is the WebSphere MQ base release number you are installing).
Right-click on the setup executable (setup.exe) and select Properties. The Properties dialog box displays for the file.
Select the Compatibility tab.
Under Compatibility mode, select the Run this program in compatibility mode for: check box, then select Windows Vista (Service Pack 2) from the list. Click OK.
Tip: Selecting Windows XP from the list may also work, though the Windows 7 architecture is closer to Vista than it is to XP.

Follow all IBM wizards when installing the IBM WebSphere MQ software. While going through the wizards, you might have to do the following depending on the WebSphere MQ version you are installing:

Verify the software requirements. Windows Vista (or later with the correctly specified compatibility mode) and WebSphere MQ Eclipse Platform Version 3.3 are required for a full install of WebSphere MQ. If either prerequisite is missing, review the Installation Prerequisites and Additional Notes sections in this document for additional information.

Specify the following when setting up the installation for use with Open PL/I:

Wizard Page/Dialog Box	Setting
Network Configuration: Configure WebSphere MQ for users defined on Windows 2000 or later domain controllers.	No
WebSphere MQ Installation: Select Installation language	As needed

Specify the following when setting up the MQ Network Configuration.

Wizard Page/Dialog Box	Action
Prepare WebSphere MQ	Click Setup the Default Configuration
WebSphere MQ Default Configuration	Click Set up Default Configuration...
Default Configuration Wizard: Select Options	Validate defaults and click Next.
Default Configuration Wizard: Join Default Cluster	For this tutorial and small, local VM installations, select the Yes, make it the repository for the cluster check box.
Default Configuration Wizard: Repository Location	For this tutorial and small, local VM installations, select No.

You can accept the installation defaults when setting up the WebSphere MQ Service Pack installation for use with Open PL/I.

You must build the DB2 XA switch module, esdb2xa.dll.

You can use either of the following methods:

Method 1

Ensure that your LIB environment variable contains the path to your Windows SDK LIB directory.
Start an Enterprise Developer command prompt, 32-bit or 64-bit depending on the application, as an administrator.
Change to the %ProgramFiles(x86)%\Micro Focus\Enterprise Developer\src\enterpriseserver\xa directory (default location).
Enter build db2.

Method 2

Ensure that your LIB environment variable contains the path to your Windows SDK LIB directory.
Start an Enterprise Developer command prompt, 32-bit or 64-bit depending on the application.
Copy all files from the %ProgramFiles(x86)%\Micro Focus\Enterprise Developer\src\enterpriseserver\xa directory (default location) to any location where you have WRITE permission.
Change to the directory containing the copied files.
Enter build db2.

Enterprise Developer builds esdb2xa.dll in the current directory.

You must create an Enterprise Server instance for WebSphere MQ to use with Enterprise Developer. A predefined and preconfigured server instance is supplied for tutorial purposes that can be used as a base for the Enterprise Server you use with WebSphere MQ. That server instance is stored in %PUBLIC%\Documents\Micro Focus\Enterprise Developer\Samples\PLI-VS\MQSDemo\plimqs_def.

DB2 must be running when using this tutorial.