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.


Syntax

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: We can only use the dltmqinst command on another installation from the one it runs from. If we only have one IBM MQ installation, the command will not work. Note: On a Solaris 10 MQ Client installation, only the root user has permissions to edit the mqinst.ini file.