[UNIX][Linux]

dltmqinst (delete MQ installation)

Delete installation entries from mqinst.ini on UNIX and Linux® systems.

Purpose

File mqinst.ini contains information about all IBM® MQ installations on a system. For more information about mqinst.ini, see Installation configuration file, mqinst.ini.
Attention: Only the user root can run this command.

Syntax

Read syntax diagramSkip visual syntax diagram dltmqinst -pInstallationPath-nInstallationName-pInstallationPath-nInstallationName1-nInstallationName-pInstallationPath1
Notes:
  • 1 When specified together, the installation name and installation path must refer to the same installation.

Parameters

-n InstallationName
The name of the installation.
-p InstallationPath
The installation path is the location where IBM MQ is installed.

Return codes

Return code Description
0 Entry deleted without error
5 Entry still active
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
98 Insufficient authority to access ini file
131 Resource problem

Example

  1. This command deletes an entry with an installation name of myInstallation, and an installation path of /opt/myInstallation:
    
    dltmqinst -n MyInstallation -p /opt/myInstallation
    
Note: You can only use the dltmqinst command on another installation from the one it runs from. If you only have one IBM MQ installation, the command will not work.
[Solaris]Note: On a Solaris 10 MQ Client installation, only the root user has permissions to edit the mqinst.ini file.