crtmqinst
Create installation entries in mqinst.ini on UNIX and Linux® systems.
Purpose
File mqinst.ini contains information about all IBM® WebSphere® MQ installations on a system. For more information about mqinst.ini, see Installation configuration file, mqinst.ini .
The
first IBM WebSphere MQ installation
is automatically given an installation name of Installation1
because
the crtmqinst command is not available until an
installation of IBM WebSphere 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
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
If you do not supply the installation name, the next available name in the series Installation1, Installation2... is used.INSTALLATIONNAME
andInstallationName
are not unique. - -p
InstallationPath
- The installation path. If you 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
- This command creates an entry with an installation name of myInstallation,
an installation path of /opt/myInstallation,
and a description
My WebSphere MQ installation
:crtmqinst -n MyInstallation -p /opt/myInstallation -d "My WebSphere MQ installation"