+

Search Tips | Advanced Search

dspmqinst (display IBM MQ installation)

Display installation entries from mqinst.ini on UNIX, Linux, and Windows, and display license entitlement information.


Purpose

The mqinst.ini file contains information about all IBM MQ installations on a system. For more information about mqinst.ini, see Installation configuration file, mqinst.ini. We can display information from all installation son the system, or about specific installations.

dspmqinst also displays information about license entitlement for each installation. The command displays the license type (Production, Trial, Beta, or Developer) and the licensed entitlement required for the IBM MQ installation. The required entitlement is reported based on the components that are installed and usage information that has been specified using the setmqinst command (see setmqinst (set IBM MQ installation)). See IBM MQ license information for more information about license types and entitlement.


Syntax

dspmqinst -pInstallationPath-nInstallationName-pInstallationPath-nInstallationName1-nInstallationName-pInstallationPath1 Notes:

  • 1 When specified together, the installation name and installation path must refer to the same installation.


Required parameters

None


Optional parameters

    -n InstallationName
    The name of the installation.

    -p InstallationPath
    The installation path.

    ?
    Display usage information.


Return codes

Return code Description
0 Entry displayed without error
36 Invalid arguments supplied
44 Entry does not exist
59 Invalid installation specified
71 Unexpected error
89 .ini file error
96 Could not lock .ini file
131 Resource problem


Examples

  1. Display details of all IBM MQ installations on the system:
    dspmqinst
    
  2. Query the entry for the installation named Installation3:
    dspmqinst -n Installation3
    
  3. Query the entry with an installation path of /opt/mqm:
    dspmqinst -p /opt/mqm
    
  4. Query the entry for the installation named Installation3. Its expected installation path is /opt/mqm:
    dspmqinst -n Installation3 -p /opt/mqm
    
  5. The following examples show the output of dspmqinst for different license types and entitlements:

    • Output for an IBM MQ client installation:
      InstName:      Installation1
      InstDesc:      My installation
      Identifier:    1
      InstPath:      /opt/mqm
      Version:       9.1.4.0
      Primary:       No
      State:         Available
      License:       Production
      Entitlement:   IBM MQ Client
      
    • Output for a standard IBM MQ server installation:
      InstName:      Installation1
      InstDesc:      My installation
      Identifier:    1
      InstPath:      /opt/mqm
      Version:       9.1.4.0
      Primary:       No
      State:         Available
      License:       Production
      Entitlement:   IBM MQ 
    • Output for an IBM MQ server installation that has been identified as a High Availability Replica:
      InstName:      Installation1
      InstDesc:      My installation
      Identifier:    1
      InstPath:      /opt/mqm
      Version:       9.1.4.0
      Primary:       No
      State:         Available
      License:       Production
      Entitlement:   IBM MQ High Availability Replica
      
    • Output for an IBM MQ Advanced server installation:
      InstName:      Installation1
      InstDesc:      My installation
      Identifier:    1
      InstPath:      /opt/mqm
      Version:       9.1.4.0
      Primary:       No
      State:         Available
      License:       Production
      Entitlement:   IBM MQ Advanced
      
    • Output for an IBM MQ Advanced server installation that has been identified as a high availability replica:
      InstName:      Installation1
      InstDesc:      My installation
      Identifier:    1
      InstPath:      /opt/mqm
      Version:       9.1.4.0
      Primary:       No
      State:         Available
      License:       Production
      Entitlement:   IBM MQ Advanced High Availability Replica
      

Last updated: 2020-10-04