dspmqver
Display WebSphere® MQ version and build information.
Purpose
Use the dspmqver command to display WebSphere MQ version and build information.
By default, the dspmqver command displays details of the installation from which it was invoked. A note is displayed if other installations exist; use the -i parameter to display their details.
Syntax
Optional parameters
- -a
- Display information about all fields and components.
- -p Components
- Display information for the components specified by component. Either a single component or multiple components
can be specified. Enter either the value of a single component or
the sum of the values of all the required components. Available components
and related values follow:
1 WebSphere MQ server, or client. 2 WebSphere MQ classes for Java. 4 WebSphere MQ classes for Java Message Service. 8 WebScale Distribution Hub 161 IBM® WebSphere MQ custom channel for Windows Communication Foundation 32 IBM Message Service Client for .NET (XMS .NET) - this component is only available on Windows 64 GSKit, or for HP Integrity NonStop Server, SSL 128 Advanced Message Security Notes:- Supported by WebSphere MQ for Windows only. If you have not installed Microsoft .NET 3 or later, the following error message is displayed:
Title: WMQWCFCustomChannelLevel.exe - Application Error
The application failed to initialize properly (0x0000135).
The default value is 1.
- Supported by WebSphere MQ for Windows only. If you have not installed Microsoft .NET 3 or later, the following error message is displayed:
- -f Fields
- Display information for the fields specified by field. Specify either a single field or multiple fields. Enter
either the value of a single field or the sum of the values of all
the required fields. Available fields and related values follow:
Information for each selected field is displayed on a separate line when the dspmqver command is run.
1 Name 2 Version, in the formV.R.M.F
:
WhereV
=Version,R
=Release,M
=Modification,
andF
=Fix pack4 Level 8 Build type 16 Platform 32 Addressing mode 64 Operating system 128 Installation path 2561 Installation description 5121 Installation name 10241 Maximum command level 20481 Primary installation 4096 Data Path Note:- Not applicable to HP Integrity NonStop Server.
The default value is 8191. This displays information for all fields.
- -b
- Omit header information from the report.
- -v
- Display verbose output.
- -i
- Display information about all installations. You cannot use this option with other options. The installation from which the dspmqver command was issued is displayed first. For any other installations, only the following fields are displayed: Name, Version, Installation name, Installation description, Installation path, and Primary installation. Not applicable to HP Integrity NonStop Server.
Return codes
Return code | Description |
---|---|
0 | Command completed normally. |
10 | Command completed with unexpected results. |
20 | An error occurred during processing. |
Examples
The following command displays WebSphere MQ version and build information,
using the default settings for -p and -f :
dspmqver
The following command displays information about
all fields and components and is the equivalent of specifying
dspmqver -p 63 -f 4095
:
dspmqver -a
The following command displays version and build
information for the WebSphere MQ classes for Java:
dspmqver -p 2
The following command displays the Common Services
for Java Platform Standard Edition, IBM WebSphere MQ, Java Message Service Client, and WebSphere MQ classes for Java Message Service:
dspmqver -p 4
The following command displays the build level
of the WebScale Distribution Hub:
dspmqver -p 8 -f 4
The following command displays the name and build
type for IBM WebSphere MQ custom channel for Windows Communication Foundation:
dspmqver -p 16 -f 9
The following command displays information about
installations of IBM WebSphere MQ.
dspmqver -i
Command Failure
The dspmqver command can fail if you try to view version or build information
for the WebSphere MQ classes for Java, and you have not correctly
configured your environment. For example, you might see the following
message:
[root@blade883 ~]# dspmqver -p2
AMQ8351: WebSphere MQ Java environment has not been configured correctly.
To resolve this problem, ensure that the path is configured to include
the JRE, and that the correct environment variables are set; for example,
by using setjmsenv
or setjmsenv64
. For example: export PATH=$PATH:/opt/mqm/java/jre/bin
cd /opt/mqm/java/bin/
. ./setjmsenv64
[root@blade883 bin]# dspmqver -p2
Name: WebSphere MQ classes for Java
Version: 7.1.0.0
Level: k000-L110908
Build Type: Production