IBM Support

Determining if the MQ client fileset package is installed

Technote (FAQ)


Question

What are the AIX, HP-UX, Linux, Solaris, and Windows operating system commands to determine if the WebSphere MQ client fileset package is installed?

Answer

The following commands can be run by any userID (that is, they are not exclusively for the "root" userID).

Notes:

  • The sample output below shows only a subset of the actual list obtained during the preparation of this document. It is not intended to show a comprehensive list.
  • Even though the specific samples are for MQ V6, the same concept applies for MQ 7.x, 8.x and 9.x
  • The strings such as "mqm.base.runtime" and the package description "WebSphere MQ Runtime for Client and Server" are built into the MQ packages and are not translated into other languages; that is, these strings are shown in English.

AIX

To get the complete list of MQ filesets in the default location of /usr/mqm issue:

lslpp -al "mqm*"

Sample output:
  Fileset                      Level  State      Description
  -----------------------------------------------------------------------
  mqm.base.runtime           6.0.0.0  COMMITTED  WebSphere MQ Runtime                                         for Client and Server
  mqm.base.samples           6.0.0.0  COMMITTED  WebSphere MQ Samples
  mqm.base.sdk               6.0.0.0  COMMITTED  WebSphere MQ Base Kit                                       for Client and Server
  mqm.client.rte             6.0.0.0  COMMITTED  WebSphere MQ Client                                         for AIX
                             6.0.2.2  COMMITTED  WebSphere MQ Client                                         for AIX
  mqm.msg.en_US              6.0.0.0  COMMITTED  WebSphere MQ Messages
  mqm.server.rte             6.0.0.0  COMMITTED  WebSphere MQ Server
  mqm.txclient.rte           6.0.0.0  COMMITTED  WebSphere MQ Extended                                       Transactional Client

To get only the MQ client fileset:

lslpp -al "mqm.client.rte"

Sample output:
  Fileset          Level  State      Description
  --------------------------------------------------------------
  mqm.client.rte 6.0.0.0  COMMITTED  WebSphere MQ Client for AIX
                 6.0.2.2  COMMITTED  WebSphere MQ Client for AIX

To get the listing across the default location and all USILs (User Specified Installation Location, which is used to install MQ in a non-default location):

lslpp -R ALL -al "*" | grep -i mq



HP-UX

To get the complete list of MQ filesets:

/usr/sbin/swlist -R MQSERIES

Sample output:
# Initializing...
# Contacting target "aemhp1"...
#
# Target:  aemhp1:/
#

# MQSERIES                              6.0.0.0        WebSphere MQ for HP-UX
  MQSERIES.MQM-BASE                     6.0.0.0        WebSphere MQ SDK fileset
  MQSERIES.MQM-CL-HPUX                  6.0.0.0        WebSphere MQ Client for HP-UX
  MQSERIES.MQM-JAVA                     6.0.0.0        WebSphere MQ Java™ Client, JMS and SOAP support
  MQSERIES.MQM-JAVASDK                  6.0.0.0        HP SDK for J2SE HP-UX 11i platform
  MQSERIES.MQM-KEYMAN                   6.0.0.0        WebSphere MQ SSL Key management
  MQSERIES.MQM-MAN                      6.0.0.0        WebSphere MQ man pages
  MQSERIES.MQM-RUNTIME                  6.0.0.0        WebSphere MQ Runtime fileset
  MQSERIES.MQM-SAMPLES                  6.0.0.0        WebSphere MQ Sample programs
  MQSERIES.MQM-SERVER                   6.0.0.0        WebSphere MQ Server fileset
  MQSERIES.MQM-TXCLIENT                 6.0.0.0        WebSphere MQ Transactional Client
# MQSERIES                              6.0.1.1        WebSphere MQ update for HP-UX (U805233)
  MQSERIES.MQM-BASE-U805233             6.0.1.1        WebSphere MQ Update for HP-UX
  MQSERIES.MQM-CL-HPUX-U805233          6.0.1.1        WebSphere MQ Update for HP-UX

To get only the MQ client fileset:

/usr/sbin/swlist -R MQSERIES | grep MQSERIES.MQM-CL-HPUX

Sample output:
  MQSERIES.MQM-CL-HPUX                  6.0.0.0        WebSphere MQ Client for HP-UX
  MQSERIES.MQM-CL-HPUX-U805233          6.0.1.1        WebSphere MQ Update for HP-UX


Linux

To get the complete list of MQ filesets:

rpm -qa | grep -i mq | sort

Sample output:
MQSeriesClient-6.0.1-0
MQSeriesClient-U806667-6.0.2-0
MQSeriesClient-U810178-6.0.2-2
MQSeriesJava-6.0.1-0
MQSeriesKeyMan-6.0.1-0
MQSeriesMan-6.0.1-0
MQSeriesRuntime-6.0.1-0
MQSeriesSamples-6.0.1-0
MQSeriesSDK-6.0.1-0
MQSeriesServer-6.0.1-0
MQSeriesTXClient-6.0.1-0

To get only the MQ client fileset:

rpm -q MQSeriesClient

Sample output:
MQSeriesClient-6.0.1-0


Solaris

To get the complete list of MQ filesets:

pkgparam mqm CLASSES

Sample output:
none base java javasdk keyman man runtime samples server sol_client txclient

To get only the MQ client fileset:

pkgparam mqm CLASSES

Note: The output is the same as above. If the following value is present, then the client is installed:
     sol_client

Sample output:
none base java javasdk keyman man runtime samples server sol_client txclient


Windows

Windows 7

+ If you want to know whether you have installed the client or the server version of WebSphere MQ in Windows, you can do the following:
1) From a command prompt, enter: regedt32

2) Expand the following:
For MQ 7.0
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\IBM\MQSeries

For MQ 7.1 and 7.5:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\IBM\WebSphere MQ\Installation

For MQ 8.0
Note that HKLM is an abbreviation for: HKEY_LOCAL_MACHINE
On 64-bit MQ installations (Server and Client):
The registry contains 64 and 32 bit MQ entries
The master copy is at HKLM\Software\IBM\WebSphere MQ
However for interoperation with 32-bit MQs, this is cloned to HKLM\Software\Wow6432Node\IBM\WebSphere MQ
Primary installation information is still cloned to HKLM\Software\Wow6432Node\IBM\MQSeries
.
You can use the following command to get the registry keys for MQ (in a single line):
reg export "HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\IBM\WebSphere MQ" c:\mq-8.txt

3) If you have installed multiple versions of MQ, then you will need to go to the next level.

For example: MQ 7.1 in Windows 7, installed in Installation1:
reg QUERY "HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\IBM\WebSphere MQ\Installation\Installation1\Components"
Local Clients\Windows NT Client REG_SZ Installed
JavaMsg REG_SZ Installed
Development Toolkit REG_SZ Installed
XA_Client REG_SZ Installed
XA_Dotnet REG_SZ Installed
XA_Java REG_SZ Installed
XR_Clients REG_SZ Installed
XR_Service REG_SZ Installed
Server REG_SZ Installed
Explorer REG_SZ Installed


Windows XP

+ If you want to know whether you have installed the client or the server version of WebSphere MQ in Windows, you can do the following:
1) From a command prompt, enter: regedt32

2) Expand the following:
HKEY_LOCAL_MACHINE -> SOFTWARE -> IBM -> MQSeries

3) Click on the folder ‘CurrentVersion’

4) Look at the Name ‘ProductType’ listed in the right pane. It should state either Client or Server under the ‘Data’ field.

+ If you want to determine the exact components installed you may look in the following registry path:
HKEY_LOCAL_MACHINE -> SOFTWARE -> IBM -> MQSeries -> CurrentVersion -> Components

If the MQ Client is installed, then the value of the registry sub key,
HKEY_LOCAL_MACHINE\SOFTWARE\IBM\MQSeries\CurrentVersion\Components
with name "Local Clients\Windows NT Client"
is set to value "Installed".

Similarly, if MQ Server is installed, then the sub key
HKEY_LOCAL_MACHINE\SOFTWARE\IBM\MQSeries\CurrentVersion\Components
with name "Server" is set to value "Installed".

+ If Windows XP is installed use the "reg.exe" registry tool that comes with the OS installation with the 'QUERY' parameter to check the components that are installed.

For example: run the following command from the command prompt in order to check the installed MQ components:

reg QUERY HKEY_LOCAL_MACHINE\SOFTWARE\IBM\MQSeries\CurrentVersion\Components

Sample output:

! REG.EXE VERSION 3.0

HKEY_LOCAL_MACHINE\SOFTWARE\IBM\MQSeries\CurrentVersion\Components
    JavaMsg     REG_SZ  Installed
    Server      REG_SZ  Installed
    Development Toolkit REG_SZ  Installed
    Explorer    REG_SZ  Installed
    Local Clients\Windows NT Client     REG_SZ  Installed



Product Alias/Synonym

WebSphere MQ WMQ

Document information

More support for: WebSphere MQ
Install / Migration

Software version: 6.0, 7.0, 7.1, 7.5, 8.0, 9.0

Operating system(s): AIX, HP-UX, Linux, Solaris, Windows

Reference #: 1299538

Modified date: 20 April 2018