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

Notes:

• ¹ 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