crtmqinst (create IBM MQ installation)

Create installation entries in 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.

The first IBM MQ installation is automatically given an installation name of Installation1 because the crtmqinst command is not available until an installation of IBM MQ is on the system. Subsequent installations can have an installation name set before installation occurs, by using the crtmqinst command. The installation name cannot be changed after installation. For more information about installation names, see Choosing an installation name.


Syntax

crtmqinst -pInstallationPath

  • -nInstallationName
  • -pInstallationPath-nInstallationName1
  • -nInstallationName-pInstallationPath1
  • -dDescriptiveText
  • Notes:

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


    Parameters

      -d
      Text that describes the installation.

      The text can be up to 64 single-byte characters, or 32 double-byte characters. The default value is all blanks. You must use quotation marks around the text if it contains spaces.

      -n InstallationName
      The name of the installation.

      The name can contain up to 16 single-byte characters and must be a combination of alphabetic and numeric characters in the ranges a-z, A-Z, and 0-9. The installation name must be unique, regardless of whether uppercase or lowercase characters are used. For example, the names INSTALLATIONNAME and InstallationName are not unique.

      If we do not supply the installation name, the next available name in the series Installation1, Installation2... is used.
      -p InstallationPath
      The installation path. If we do not supply the installation path, /opt/mqm is used on UNIX and Linux systems, and /usr/mqm is used on AIX .


    Return codes

    Return code Description
    0 Entry created without error
    10 Invalid installation level
    36 Invalid arguments supplied
    37 Descriptive text was in error
    45 Entry already exists
    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 creates an entry with an installation name of myInstallation, an installation path of /opt/myInstallation, and a description My IBM MQ installation: 
      crtmqinst -n MyInstallation -p /opt/myInstallation -d "My IBM MQ installation"
    Quotation marks are needed because the descriptive text contains spaces. Note: On UNIX, the crtmqinst command must be run by the root user because full access permissions are required to write to the mqinst.ini configuration file.