Displaying the WebSphere MQ version

Technote (FAQ)


Question

How do I display the version and maintenance level of WebSphere MQ?

Answer

WebSphere MQ provides a program called dspmqver which can display the version of WebSphere MQ and its installed components like the WebSphere MQ Java™ and JMS classes, WebSphere MQ Telemetry, and the IBM Global Security Kit for WebSphere MQ. On IBM i, WebSphere MQ also provides the DSPMQMVER CL command which displays the main product version only.



Multiple installations

WebSphere MQ V7.5 and V7.1 on Linux, UNIX and Windows support multiple installations on a single system and can coexist with a previous installation of WebSphere MQ V7.0.1.6 or later. The dspmqver command from a WebSphere MQ V7.1 or later installation can print a summary of all your installed versions:


    Linux, UNIX and Windows

    > dspmqver -i
    Name:        WebSphere MQ
    Version:     7.5.0.0
    Level:       p000-L120604
    BuildType:   IKAP - (Production)
    Platform:    WebSphere MQ for AIX
    Mode:        64-bit
    O/S:         AIX 7.1
    InstName:    Installation2
    InstDesc:    
    InstPath:    /usr/IBM/WMQ-7.5/usr/mqm
    DataPath:    /var/mqm
    Primary:     No
    MaxCmdLevel: 750

    Name:        WebSphere MQ
    Version:     7.0.1.10
    InstName:    Installation0
    InstDesc:    IBM WebSphere MQ Installation
    InstPath:    /usr/mqm
    Primary:     Yes

    Name:        WebSphere MQ
    Version:     7.1.0.2
    InstName:    Installation1
    InstDesc:    
    InstPath:    /usr/IBM/WMQ-7.1/usr/mqm
    Primary:     No



If you wish to see detailed output for a particular installation, first use the setmqenv command to set up your environment for that installation. On Linux and UNIX systems you must source the setmqenv script using a dot (full stop, or period) in order to invoke it properly:


    Linux and UNIX

    sh> . /path/to/wmq-7.1/bin/setmqenv -n Installation3
    sh> dspmqver -a

    Windows

    C:\> "C:\Program Files (x86)\IBM\WebSphere MQ_2\bin\setmqenv" -n Installation5
    C:\> dspmqver -a




The setmqenv command updates your PATH so that dspmqver runs from the intended installation, and it also sets your CLASSPATH so that dspmqver can display the level of WebSphere MQ Java components.

WebSphere MQ V7.5

The dspmqver command prints the version of the current WebSphere MQ installation and its components.


    Linux, UNIX and Windows

    > dspmqver -a
    Name:        WebSphere MQ
    Version:     7.5.0.0
    Level:       p000-L120604
    BuildType:   IKAP - (Production)
    Platform:    WebSphere MQ for AIX
    Mode:        64-bit
    O/S:         AIX 6.1
    InstName:    Installation4
    InstDesc:
    InstPath:    /usr/IBM/WMQ-7.5-A/usr/mqm
    DataPath:    /var/mqm
    Primary:     No
    MaxCmdLevel: 750

    Name:        WebSphere MQ classes for Java
    Version:     7.5.0.0
    Level:       p000-L120604
    Build Type:  Production

    Name:        Java Message Service Client          
    Version:     7.5.0.0
    Level:       p000-L120604                            
    Build Type:  Production                        

    Name:        WebSphere MQ classes for Java Message Service
    Version:     7.5.0.0                        
    Level:       p000-L120604            
    Build Type:  Production

    Name:        IBM WebSphere MQ Telemetry
    Version:     7.5.0.0                
    Level:       p000-L120604
    Build Type:  Production

    Name:        IBM WebSphere MQ JMS Provider
    Version:     7.5.0.0
    Level:       p000-L120604 mqjbnd=p000-L120604
    Build Type:  Production

    Name:        Common Services for Java Platform, Standard Edition
    Version:     7.5.0.0
    Level:       p000-L120604
    Build Type:  Production


    DistHub Build Type:
    DistHub Build Level: DH000-L50930
    Webscale Distribution Hub Core
    Name:        WebSphere MQ Advanced Message Security
    Version:     7.5.0.0
    Level:       p000-L120604
    BuildType:   IKAP - (Production)

    Name:        IBM Global Security Kit for WebSphere MQ
    Version:     8.0.14.21
    Build Type:  Production
    Mode:        32-bit

    Name:        IBM Global Security Kit for WebSphere MQ
    Version:     8.0.14.21
    Build Type:  Production
    Mode:        64-bit




WebSphere MQ V7.5 includes two new components which were previously available only as separate product editions: Managed File Transfer, formerly available in WebSphere MQ File Transfer Edition, and Advanced Message Security, formerly available in WebSphere MQ Extended Security Edition. In order to provide continuity to users upgrading from those editions, WebSphere MQ V7.5 includes two additional commands to display the version of those components:

    Linux, UNIX and Windows

    > dspmqsver
    Name:        WebSphere MQ Advanced Message Security
    Version:     7.5.0.0
    Level:       p000-L120604
    BuildType:   IKAP - (Production)


    > fteDisplayVersion
    5724-H72 Copyright IBM Corp.  2008, 2012.  ALL RIGHTS RESERVED
    Name:          WebSphere MQ Managed File Transfer
    Version:       7.5



WebSphere MQ V7.1 and V7.0.1

WebSphere MQ V7.0.1 introduced the "-a" flag to display the level of all installed WebSphere MQ components. The output looks similar to that shown above, though the number of components listed will vary based on the platform. On IBM i, the DSPMQMVER command takes no arguments and prints only the main product version:


    Linux, UNIX and Windows

    > dspmqver -a

    IBM i Q Shell

    ===> /QSYS.LIB/QMQM.LIB/DSPMQVER.PGM -a

    IBM i Command Line

    ===> DSPMQMVER

                                  Display MQ Version

    Name . . . . . . . . . :   WebSphere MQ

    Version  . . . . . . . :   7.1.0.2
    CMVC Level . . . . . . :   p710-002-121018
    BuildType  . . . . . . :   IKAP - (Production)




WebSphere MQ V7.0.0

With WebSphere MQ V7.0.0 and older versions, you must use the "-p" flag to display the level of select WebSphere MQ components. The dspmqver examples below show which value to use to display all WebSphere MQ components for the platform. On IBM i, the DSPMQMVER command takes no arguments and prints only the main product version:


    Linux and UNIX

    sh> dspmqver -p 15

    Windows

    C:\> dspmqver -p 63

    IBM i Q Shell

    ===> /QSYS.LIB/QMQM.LIB/DSPMQVER.PGM -p 15

    IBM i Command Line

    ===> DSPMQMVER




WebSphere MQ V6.0

WebSphere MQ V6.0 uses the dspmqver command to display version information. The old mqver command simply prints a message recommending dspmqver instead:


    HP OpenVMS

    $ dspmqver -p 15

    Linux, UNIX and Windows

    > dspmqver -p 15

    IBM i Q Shell

    ===> /QSYS.LIB/QMQM.LIB/DSPMQVER.PGM -p 15

    IBM i Command Line

    ===> DSPMQMVER



WebSphere MQ V5.3

WebSphere MQ V5.3 introduced the dspmqver command to replace the older mqver command. On most platforms, the V5.3 dspmqver and mqver commands are the same:


    HP NonStop

    Guardian users should run the osh TACL command to switch to the OSS environment first.

    osh> dspmqver
    Name: WebSphere MQ
    Version: 531.9 FP5319
    CMVC level: WMQ-5-3-1-9
    BuildType: IKAP - (Production)


    When working with IBM support, please provide output in the following form as well:

    osh> dspmqver -V
    T0085H06_30JUN2012_V53_1_9

    Linux and UNIX

    sh> dspmqver -p 7

    Windows

    C:\> dspmqver -p 7

    IBM i Command Line

    ===> CALL PGM(QMQM/MQVER)




Troubleshooting dspmqver

  1. If you have absolutely no idea what version of WebSphere MQ is installed on your system, try running dspmqver with no flags. If the dspmqver command is not found, check to see whether your system has any information about WebSphere MQ installations and run the dspmqver command from the installation directories (if any).

  2. If dspmqver prints the message "AMQ8351: WebSphere MQ Java environment has not been configured properly" then you must set or double-check your CLASSPATH as shown below. On IBM i, Linux and UNIX you must ensure you are exporting the CLASSPATH variable so that it will be seen by dspmqver. If you are using the setjmsenv or setjmsenv64 script, make sure you source it using the dot syntax rather than running the script.

  3. If dspmqver prints a message like "Exception in thread "main" java.lang.UnsupportedClassVersionError: com/ibm/mq/MQJavaLevel (Unsupported major.minor version 48.0)" then your JVM is too old. Run 'java -version' to check its level and compare it against the WebSphere MQ System Requirements. Install a newer Java runtime or modify your PATH to use a newer Java runtime if one is already on the system.

  4. If dspmqver prints a message like "mqjbnd=CC=2;RC=2495;AMQ8568: The native JNI library 'mqjbnd' was not found. [3=mqjbnd]::Can't find library mqjbnd (libmqjbnd.a or .so) in sun.boot.library.path or java.library.path" then you must update the library path as shown above. On AIX the library path variable is called LIBPATH, on HP-UX it is SHLIB_PATH, and on Linux and Solaris systems it is called LD_LIBRARY_PATH. Be sure to point to the WebSphere MQ java/lib directory for 32-bit Java runtimes and java/lib64 for 64-bit Java runtimes, and export the library path variable so that it will be seen by dspmqver.



WebSphere MQ Java environment

The dspmqver command requires a Java runtime in order to display the level of certain WebSphere MQ Java components. Please ensure that your PATH includes a Java runtime, or else dspmqver may not be able to display those components.

If you ran the WebSphere MQ V7.1 and later setmqenv command on Linux, UNIX or Windows, then your environment has already been configured for dspmqver to display all components.

If you are running WebSphere MQ V7.1 on IBM i, or if you are running WebSphere MQ V7.0 or V6.0 on IBM i, Linux or UNIX, you can use the setjmsenv script to set your CLASSPATH. Most WebSphere MQ V7.0 platforms on Linux and UNIX also provide a setjmsenv64 script to use with 64-bit Java runtimes. Source the setjmsenv or setjmsenv64 script using a dot (full stop, or period) in order to invoke it properly:


    AIX

    sh> . /usr/mqm/java/bin/setjmsenv64

    sh> . /usr/mqm/java/bin/setjmsenv

    HP-UX, Linux and Solaris

    sh> . /opt/mqm/java/bin/setjmsenv64

    sh> . /opt/mqm/java/bin/setjmsenv

    IBM i Q Shell

    ===> . /QIBM/ProdData/mqm/java/bin/setjmsenv





If your WebSphere MQ installation does not provide the setjmsenv or setjmsenv64 scripts, then you must set your CLASSPATH manually as shown below before running dspmqver. Set your library path on Linux and UNIX systems to include either the WebSphere MQ java/lib or java/lib64 directory, depending on whether the Java runtime in your PATH is 32- or 64-bit:

    AIX

    sh> export CLASSPATH=/usr/mqm/java/lib/com.ibm.mq.jar:/usr/mqm/java/lib/com.ibm.mqjms.jar
    sh> export LIBPATH=/usr/mqm/java/lib64

    HP-UX

    sh> export CLASSPATH=/opt/mqm/java/lib/com.ibm.mq.jar:/opt/mqm/java/lib/com.ibm.mqjms.jar
    sh> export SHLIB_PATH=/opt/mqm/java/lib

    Linux

    sh> export CLASSPATH=/opt/mqm/java/lib/com.ibm.mq.jar:/opt/mqm/java/lib/com.ibm.mqjms.jar
    sh> export LD_LIBRARY_PATH=/opt/mqm/java/lib64

    Solaris

    sh> export CLASSPATH=/opt/mqm/java/lib/com.ibm.mq.jar:/opt/mqm/java/lib/com.ibm.mqjms.jar
    sh> export LD_LIBRARY_PATH=/opt/mqm/java/lib64

    Windows

    On Windows, the separator between CLASSPATH entries must be a semicolon, for example:


    C:\>
     set CLASSPATH=C:\Program Files (x86)\IBM\WebSphere MQ\java\lib\com.ibm.mq.jar;C:\Program Files (x86)\IBM\WebSphere MQ\java\lib\com.ibm.mqjms.jar

    IBM i Q Shell

    Environment changes made in the Q Shell are temporary:

    ===> export CLASSPATH=/QIBM/ProdData/mqm/java/lib/com.ibm.mq.jar:/QIBM/ProdData/mqm/java/lib/com.ibm.mqjms.jar

    IBM i Command Line

    Environment changes made in the Command Line are permanent:

    ===> ADDENVVAR(CLASSPATH) VALUE('/QIBM/ProdData/mqm/java/lib/com.ibm.mq.jar:/QIBM/ProdData/mqm/java/lib/com.ibm.mqjms.jar') LEVEL(*SYS)


Once your PATH, CLASSPATH, and library path (in some cases) has been updated, you can use the dspmqver command to display the version of all installed WebSphere MQ components, including WebSphere MQ Java and JMS components and the bindings libraries.

Product Alias/Synonym

WebSphere MQ WMQ

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

WebSphere MQ
Documentation

Software version:

5.3, 6.0, 7.0, 7.1, 7.5

Operating system(s):

AIX, HP-UX, IBM i, Linux, Solaris, Windows

Software edition:

All Editions

Reference #:

1621707

Modified date:

2013-06-19

Translate my page

Machine Translation

Content navigation