dspmqinst (display IBM MQ installation)

[MQ 9.2.0 Jul 2020] Display installation entries from mqinst.ini on AIX®, 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. You can display information from all installation son the system, or about specific installations.

[MQ 9.2.0 Jul 2020] 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

Table 1. Return code identifiers and descriptions
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

Display details of all IBM MQ installations on the system:
```
dspmqinst
```
Query the entry for the installation named Installation3:
```
dspmqinst -n Installation3
```
Query the entry with an installation path of /opt/mqm:
```
dspmqinst -p /opt/mqm
```
Query the entry for the installation named Installation3. Its expected installation path is /opt/mqm:
```
dspmqinst -n Installation3 -p /opt/mqm
```

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 high availability replica entitlement:

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

Output for an IBM MQ Advanced server installation that has non production entitlement:

InstName:      Installation1
InstDesc:      My installation
Identifier:    1
InstPath:      /opt/mqm
Version:       9.2.2.0
Primary:       No
State:         Available
License:       Production
Entitlement:   IBM MQ Advanced (Non-production)