crtmqdir (create IBM MQ directories)
Create, check, and correct IBM MQ directories and files.
Purpose
Use the crtmqdir command to check that the necessary directories and files used by IBM MQ exist and have the appropriate ownership and permissions. The command can optionally create any missing directories or files, and correct any inconsistent ownership or permissions.
The system-wide directories and files are created as part of the IBM MQ installation procedure. The tool can subsequently be run to check or ensure that the necessary IBM MQ directories and files continue to have appropriate ownership and permissions.
Important: You must have sufficient permission to determine whether the configuration is correct and, optionally, correct that configuration.On Windows, this typically means that you are a member of the IBM MQ administration group. This is necessary when using the -a or -m parameters.
On IBM i, you must run the command as a member of the IBM MQ administrative group. This is necessary when using the -a or -m parameters, together with the -f parameter.
On UNIX, this typically means
that you are the mqm user. This is necessary when using the -a
or -m parameters, together with the -f parameter.
Depending on the configuration, the crtmqdir command might require you to be an operating system administrator, or superuser.
Note: The security of data path/log/qm, on UNIX, is set to 2770.
Syntax
Required parameters
- Specify one of the following parameters only:
- -a
- Check all directories; that is, system-wide directories and all the queue managers.Attention: The queue manager must be associated with the current installation.
- -m
- Check directories for the specified queue manager name.Attention: The queue manager must be associated with the current installation.
- -s
- Check the system-wide directories; that is, directories that are not queue manager specific.
Optional parameters
- -f
- This option causes directories or files to be created if they are missing, and on UNIX only, ownership or permissions to be corrected if they
are inappropriately set.
If -a or -m is specified on UNIX, as a minimum, the program attempts to correct ownership or permissions on files that were created at the time of queue manager creation.
- -x level of permissions
- Specify one of the following values only:
- standard
- By default, directories and files get a standard set of permissions, but a high level of permissions can be requested.
- high
- This option ensures that files in the following directories on AIX , HP-UX,
Linux , or Solaris, can be deleted only by the owner:
- errors
- trace
- webui
Return codes
| Return code | Description |
|---|---|
| 0 | Successful completion |
| 10 | A warning occurred |
| 20 | An error occurred |
Examples
- The following command checks and fixes the system-wide
directories:
crtmqdir -s -f
- The following command checks (but does not fix) queue manager
QM1:
crtmqdir -m Qm1