IBM Support

Displaying the operating system version and maintenance level

Question & Answer


Question

How do I display the version and maintenance level of the operating system on which IBM MQ is running?

Answer

Each operating system on which IBM MQ runs has a different method for displaying its version and maintenance. Please be aware that some of the output from the operating systems has been shortened in the interests of clarity:

 
 

AIX

According to the AIX service strategy, each supported release of AIX will receive a new Technology Level update every one to two years (more frequently for newer AIX versions), with Service Packs for each supported Technology Level released approximately twice per year. IBM announces the End of Service Pack Support (EoSPS) for each Service Pack, after which fixes will no longer be made available for that level of AIX:

 

Display the version and maintenance level

 

Use the oslevel command to display the AIX version, release, Technology Level (TL), Service Pack (SP) and build date. For example, this output shows AIX V7.1 Technology Level 5, Service Pack 4, built in the 14th week of 2019.  Additional information about the system hardware and configuration is available from the prtconf command:

sh> oslevel -s
7100-05-04-1914

sh> prtconf
System Model: IBM,8203-E4A
Machine Serial Number: 0000000
Processor Type: PowerPC_POWER6
Processor Implementation Mode: POWER 6
Processor Version: PV_6
Number Of Processors: 4
Processor Clock Speed: 4204 MHz
CPU Type: 64-bit
Kernel Type: 64-bit
LPAR Info: 1 06-4DC34
Memory Size: 7712 MB
Good Memory Size: 7712 MB
...
 

Display back-level LPPs

Sometimes the Technology Level or Service Pack reported by oslevel is older than you expect, simply because one or two LPPs (Licensed Program Products) are back-level. You can use the oslevel command to determine which LPPs must be updated to reach a particular level.  First, use the oslevel command to list the service pack levels known to your system:


sh> oslevel -sq
Known Service Packs
-------------------
7100-05-04-1914
7100-05-04-1913
7100-05-03-1846
7100-05-03-1838
7100-05-03-1837

...

AIX keeps a list of LPP levels included in each known service pack. Use the oslevel command to identify which LPPs on your system are older than the ones in the service pack. For example, this output shows an AIX system which would be at service pack 7100-05-04-1914 if only the sysmgt.cfgassist LPP were updated to 7.1.5.31:

sh> oslevel -sl 7100-05-04-1914
Fileset                                 Actual Level       Service Pack Level
-----------------------------------------------------------------------------
sysmgt.cfgassist                        7.1.5.0            7.1.5.31
Use IBM Fix Central to download AIX updates and bring any back level LPPs up to the desired Technology Level and Service Pack. Bear in mind that Fix Central may have newer maintenance levels available than those known to your system.
 

Display LPP version and history

You can use the lslpp command to display the version and installation history of LPPs.  Be sure to use the -R option to display information about LPPs installed in a User-Specified Installation Location (USIL):

sh> lslpp -h mqm.server.rte

  Fileset         Level     Action       Status       Date         Time        
  ----------------------------------------------------------------------------
Path: /usr/lib/objrepos
  mqm.server.rte
                  8.0.0.0   COMMIT       COMPLETE     08/11/14     15:36:37    
                  8.0.0.3   COMMIT       COMPLETE     03/11/16     16:42:10    
                  8.0.0.7   COMMIT       COMPLETE     10/18/17     08:17:02    
                 8.0.0.10   COMMIT       COMPLETE     12/13/18     21:58:47    
                 8.0.0.12   COMMIT       COMPLETE     05/21/19     15:57:00

sh> lslpp -R /usr/mqm91 -h mqm.server.rte

  Fileset         Level     Action       Status       Date         Time        
  ----------------------------------------------------------------------------
Path: /usr/mqm91/usr/lib/objrepos
  mqm.server.rte
                  9.1.0.0   COMMIT       COMPLETE     08/21/18     19:27:41    
                  9.1.0.2   COMMIT       COMPLETE     05/16/19     20:01:05
 
 

HP-UX

IBM MQ and WebSphere MQ releases from V7.0 through V9.0 run on HP Integrity systems, based on the Itanium architecture. Only WebSphere MQ V7.0 and prior versions support HP PA-RISC systems. 

Display the version and installed maintenance bundles

 

Use the uname command to display the HP-UX version and release, in this example 11.31:

sh> uname -a
HP-UX hp3 B.11.31 U ia64 3875925350 unlimited-user license


Use the machinfo command to display the HP machine type, architecture, and other details:

sh> machinfo
CPU info:
  2 Intel(R) Itanium 2 9000 series processors (1.6GHz, 9MB)
          533 MT/s bus, CPU Version C2
          2 logical processors

Memory: 16384 MB (16 GB)
...
Platform info:
   Model:                  "ia64 hp server rx8640"
...


If you want to display more information about operating system maintenance bundles, the following command is a good place to start:

sh> /usr/sbin/swlist -l bundle | grep -Ei 'GOLD|QPK'
  QPKAPPS       B.11.31.0809.326 Applications Patches for HP-UX 11i v3, September 2008
  QPKBASE       B.11.31.0709.312a Base Quality Pack Bundle for HP-UX 11i v3, September 2007
  QPKBASE       B.11.31.0803.318a Base Quality Pack Bundle for HP-UX 11i v3, March 2008
  QPKBASE       B.11.31.0809.326 Base Quality Pack Bundle for HP-UX 11i v3, September 2008
 

Display installed patches

 

For more information about patches, you can use the show_patches command. The -a flag will show active patches, while -s will show patches that have been superseded by newer patches:

sh> /usr/contrib/bin/show_patches -a

    Active                             Patch
    Patch                           Description
  ----------            -----------------------------------------
  PHCO_36003            logins(1M) cumulative patch
  PHCO_36032            killall(1M) cumulative patch
  PHCO_36038            esmd(1M) cumulative patch
  PHCO_36075            documentation change needed for stat(5)
  ...


If you want to check for a specific patch you can examine the output of the show_patches command or use swlist:

sh> /usr/sbin/swlist -l patch -x show_superseded_patches=true -a superseded_by PHKL_38077
# Initializing...
# Contacting target "hp3"...
# Target:  hp3:/
#

# PHKL_38077
# PHKL_38077.C-INC
# PHKL_38077.CORE2-KRN
# PHKL_38077.PAUX-ENG-A-MAN


 

HPE NonStop

IBM MQ V8.1 and V8.0 for HPE NonStop supports NS7-Series and NS3-Series HPE Integrity NonStop X (L-Series) and NB-Series HPE Integrity NonStop Blade System (J-Series) hardware.  WebSphere MQ V5.3.1 and V5.3 for HPE NonStop supports HPE Integrity NonStop i and HP NonStop S-Series. The former IBM MQ V8.0 (MQC8) and WebSphere MQ V7.1 (MAT1) clients supported only HP Integrity NonStop i systems:

 

Display the NonStop RVU

You can use the OSS 'uname' command to see the NonStop operating system RVU (Release Version Update). Guardian users should run the 'osh' TACL command to switch to the OSS environment in order to use uname.  The NonStop RVU includes a letter indicating the hardware series on which it runs:

  • L  HPE Integrity NonStop X systems (x86-64)
  • J  HPE Integrity NonStop i systems (Itanium multi-core processors)
  • H  HPE Integrity NonStop i systems (Itanium single-core processors)
  • G  HP NonStop S-series systems (MIPS)
The two examples below show output from an HP Integrity NonStop X machine (x86-64) running L16.05 and from an HP Integrity NonStop BladeSystems machine (Itanium) running J06.14:
osh> uname -a
NONSTOP_KERNEL nss1 L16 05 NSX-G

osh> uname -a
NONSTOP_KERNEL nss2 J06 14 NSE-AB


The MQ V8.1 and V8.0 dspmqver command also displays some operating system information:

osh> dspmqver -v
Name:        IBM MQ
Version:     8.1.0.0
Level:       p800-L190430-085856
BuildType:   IKAP - (Production)
Platform:    IBM MQ for HPE NonStop X (x86)
Mode:        64-bit
O/S:         HPE NonStop L16.05, NSX-G 000000
InstName:    Installation1
InstDesc:
Primary:     Yes
InstPath:    /software/mq810/opt/mqm
InstPathG:   $MQCA.MQ810
DataPath:    /software/mq810/var/mqm
MaxCmdLevel: 802
LicenseType: Production
 

Display installed Software Product Revisions (SPRs)

In order to see what software product revisions (SPRs) are installed on your system, you should use the Distributed Systems Management/Software Configuration Manager (DSM/SCM) tool. For information on installing and using this tool, please refer to the DSM/SCM User's Guide.

 

IBM i

The iBM i version and PTFs are available through the IBM i Command Line.

Display the version and release

Use the GO LICPGM command, then choose option 10 and press F11 to display the IBM i version and release:

===> GO LICPGM
===> 10
F11



                      Display Installed Licensed Programs

 Licensed  Installed
 Program   Release     Description
 5770SS1   V7R1M0 L00  Library QGPL
 5770SS1   V7R1M0 L00  Library QUSRSYS
 5770SS1   V7R1M0 L00  IBM i
 5770SS1   V7R1M0      Extended Base Support
 5770SS1   V7R1M0      Online Information
 5770SS1   V7R1M0      Extended Base Directory Support
 ...
 

Display installed PTFs

If you need to display the maintenance applied to the system, you can use the licensed program name from your system with the DSPPTF command, for example:
 

===> DSPPTF LICPGM(5770SS1)

                               Display PTF Status                      
                                                             System:   MQ1
 Product ID  . . . . . . . . . . . . . :   5770SS1                      
 IPL source  . . . . . . . . . . . . . :   ##MACH#B                    
 Release of base option  . . . . . . . :   V7R1M0 L00                  
                                                                       
                                                                       
 Type options, press Enter.                                            
   5=Display PTF details   6=Print cover letter   8=Display cover letter
                                                                       
      PTF                                                   IPL        
 Opt  ID       Status                                       Action      
  _   TC12279  Temporarily applied                          None        
  _   TC12115  Permanently applied                          None        
  _   TC11270  Superseded                                   None        
  _   TC11116  Permanently applied                          None
      ...


If you are looking for a specific PTF, you may find it easiest to send the output from DSPPTF to a spool file, then review and search the output using WRKSPLF Option 5:

===> DSPPTF LICPGM(*ALL) OUTPUT(*PRINT)
===> WRKSPLF

 

Linux

Most Linux systems are based on a specific distribution provided by a vendor. The distribution name and version are independent of the Linux kernel version.

 

Display distribution details and kernel version

Display the /etc/*-release file for your system, commonly /etc/os-release (Ubuntu and most recent distributions), /etc/redhat-release, /etc/SuSE-release, or /etc/system-release:

sh> cat /etc/os-release
NAME="Red Hat Enterprise Linux Server"
VERSION="7.4 (Maipo)"
ID="rhel"
ID_LIKE="fedora"
VARIANT="Server"
VARIANT_ID="server"
VERSION_ID="7.4"
PRETTY_NAME="Red Hat Enterprise Linux Server 7.4 (Maipo)"

...


Next, use the uname command to display your Linux kernel version and hardware architecture:

sh> uname -a
Linux localhost.localdomain 3.10.0-693.el7.x86_64 #1 SMP Thu Jul 6 19:56:57 EDT 2017 x86_64 x86_64 x86_64 GNU/Linux

Display package information (RPM-based systems)

Use the rpm command query your system to see which software packages are installed and their version. The "--last" option shows the most recently changed packages first.  For example:

sh> rpm -qa --last "MQSeries*"
MQSeriesSDK-U9102-9.1.0-2.x86_64              Wed 08 May 2019 01:20:19 PM EDT
MQSeriesSamples-U9102-9.1.0-2.x86_64          Wed 08 May 2019 01:20:14 PM EDT
MQSeriesMan-U9102-9.1.0-2.x86_64              Wed 08 May 2019 01:19:41 PM EDT
MQSeriesGSKit-U9102-9.1.0-2.x86_64            Wed 08 May 2019 01:19:38 PM EDT
MQSeriesClient-U9102-9.1.0-2.x86_64           Wed 08 May 2019 01:18:38 PM EDT
MQSeriesServer-U9102-9.1.0-2.x86_64           Wed 08 May 2019 01:17:47 PM EDT
MQSeriesRuntime-U9102-9.1.0-2.x86_64          Wed 08 May 2019 01:17:15 PM EDT
MQSeriesSDK-9.1.0-0.x86_64                    Thu 14 Feb 2019 05:14:48 PM EDT
MQSeriesSamples-9.1.0-0.x86_64                Thu 14 Feb 2019 05:14:48 PM EDT
MQSeriesMan-9.1.0-0.x86_64                    Thu 14 Feb 2019 05:14:44 PM EDT
MQSeriesGSKit-9.1.0-0.x86_64                  Thu 14 Feb 2019 05:14:43 PM EDT
MQSeriesClient-9.1.0-0.x86_64                 Thu 14 Feb 2019 05:14:40 PM EDT
MQSeriesServer-9.1.0-0.x86_64                 Thu 14 Feb 2019 05:13:21 PM EDT
MQSeriesRuntime-9.1.0-0.x86_64                Thu 14 Feb 2019 05:12:59 PM EDT

...

If you wish to see more information about a specific package, rpm can display it:

sh> rpm -qi MQSeriesServer-U9102
Name        : MQSeriesServer-U9102
Version     : 9.1.0
Release     : 2
Architecture: x86_64
Install Date: Wed 08 May 2019 01:17:47 PM EDT
Group       : Applications/Networking
Size        : 72730456
License     : Commercial
Signature   : (none)
Source RPM  : MQSeriesServer-U9102-9.1.0-2.src.rpm
Build Date  : Tue 02 Apr 2019 01:18:35 PM EDT
Build Host  : legate.hursley.ibm.com
Relocations : /opt/mqm 
Vendor      : IBM
Summary     : IBM MQ Server FileSet (Maintenance Pack U9102)
Description :
IBM MQ for Linux for x86_64
U9102

Display package information (Ubuntu systems)

Use apt or dpkg to list installed packages:

sh> apt list "ibmmq-*"
Desired=Unknown/Install/Remove/Purge/Hold
| Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/trig-aWait/Trig-pend
|/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad)
||/ Name               Version   Architecture   Description
+++-==================-=========-==============-=========================================================
ii  ibmmq-amqp         9.1.0.0   amd64          IBM MQ AMQP Service
ii  ibmmq-amqp-u9102   9.1.0.2   amd64          IBM MQ AMQP Service (Maintenance Pack U9102)
ii  ibmmq-ams          9.1.0.0   amd64          IBM MQ Advanced Message Security
ii  ibmmq-ams-u9102    9.1.0.2   amd64          IBM MQ Advanced Message Security (Maintenance Pack U9102)

...
sh> dpkg -l "ibmmq-*"
ibmmq-amqp/unknown,now 9.1.0.0 amd64 [installed]
ibmmq-amqp-u9102/unknown,now 9.1.0.2 amd64 [installed]
ibmmq-ams/unknown,now 9.1.0.0 amd64 [installed]
ibmmq-ams-u9102/unknown,now 9.1.0.2 amd64 [installed]

...
 

If you wish to see more information about a specific package, both apt and dpkg can display it:

sh> apt show ibmmq-server-u9102
Package: ibmmq-server-u9102
Version: 9.1.0.2
Priority: extra
Section: non-free/misc
Maintainer: IBM
Installed-Size: 79.5 MB
Pre-Depends: ibmmq-runtime-u9102 (>=9.1.0-2), ibmmq-server (>=9.1.0)
Download-Size: 33.5 MB
APT-Manual-Installed: yes
APT-Sources: file:/tmp/9.1.0.2 ./ Packages
Description: IBM MQ Server FileSet (Maintenance Pack U9102)
sh> dpkg -s ibmmq-server-u9102

[Shows the exact same information as the apt command]

 

Solaris

IBM MQ 9.1, 9.0, 8.0, and WebSphere MQ 7.5 and older support Solaris on both SPARC and x86-64 systems.

Display the version, release and hardware

Use the uname command to display your Solaris version, release, and hardware architecture:

sh> uname -a
SunOS sun4 5.10 Generic sun4u sparc SUNW,Sun-Fire-V44


You can also display the /etc/release file for more information:

sh> cat /etc/release
                         Solaris 10 3/05 s10_74L2a SPARC
           Copyright 2005 Sun Microsystems, Inc.  All Rights Reserved.
                        Use is subject to license terms.
                            Assembled 22 January 2005
 

Display installed patches

Use the showrev command to view even more information about the system, including installed patches:

sh> showrev -a
Hostname: sun4
Hostid: 8333e041
Release: 5.10
Kernel architecture: sun4u
Application architecture: sparc
Hardware provider: Sun_Microsystems
Kernel version: SunOS 5.10 Generic

OpenWindows version:
Solaris X11 Version 6.6.2 15 December 2004

Patch: 120068-02 Obsoletes:  Requires:  Incompatibles:  Packages: SUNWtnetd
Patch: 116298-08 Obsoletes:  Requires:  Incompatibles:  Packages: SUNWxsrt, SUNWxrgrt, SUNWxrpcrt, SUNWjaxp
Patch: 116302-02 Obsoletes:  Requires:  Incompatibles:  Packages: SUNWxrpcrt
...
 

Windows

Windows systems may have Service Packs which bundle patches and features, and Hotfixes which can be applied individually to address specific issues.

 

Display the version and build level

Run the winver command to see the Windows version and build level.

winver

Display installed patches and other system information

Run the systeminfo command from a command prompt to display your Windows version, Service Pack, Hotfixes, and other information.

    C:\Users\user1> systeminfo
    Host Name:                 WIN1
    OS Name:                   Microsoft Windows Server 2016 Standard
    OS Version:                10.0.14393 N/A Build 14393
    OS Manufacturer:           Microsoft Corporation
    OS Configuration:          Standalone Server
    OS Build Type:             Multiprocessor Free
    ...

    Alternatively, run the Get-SystemInfo cmdlet from a PowerShell prompt to display your Windows version, Service Pack, Hotfixes, and other information.

      PS C:\Users\user1> Get-ComputerInfo

      WindowsBuildLabEx                                       : 14393.2906.amd64fre.rs1_release_inmarket.190401-1809
      WindowsCurrentVersion                                   : 6.3
      WindowsEditionId                                        : ServerStandard
      WindowsInstallationType                                 : Server
      WindowsInstallDateFromRegistry                          : 5/3/2019 4:25:08 PM
      WindowsProductId                                        : 00000-00000-00000-00000
      WindowsProductName                                      : Windows Server 2016 Standard

      If you need to send this information to IBM, you should redirect the output to a file:

      C:\Users\user1> systeminfo > systeminfo.txt
      PS C:\Users\user1> Get-ComputerInfo > computerinfo.txt

      [{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Component":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF012","label":"IBM i"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"9.1;9.0;8.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Component":"","Platform":[{"code":"PF010","label":"HP-UX"}],"Version":"9.0;8.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Component":"","Platform":[{"code":"PF011","label":"HPE NonStop"}],"Version":"8.1;8..0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSFKSJ","label":"WebSphere MQ"},"Component":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.5;7.1;7.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSFKSJ","label":"WebSphere MQ"},"Component":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1;7.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSFKSJ","label":"WebSphere MQ"},"Component":"","Platform":[{"code":"PF011","label":"HPE NonStop"}],"Version":"5.3.1;5.3","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

      Product Synonym

      WebSphere MQ WMQ IBMMQ

      Document Information

      Modified date:
      03 June 2019

      UID

      swg21634678