Directory content on AIX and Linux systems

Content of the directories associated with a queue manager.

For information about the location of the product files, see Choosing an installation location

For information about alternative directory configurations, see Planning file system support on Multiplatforms.

The following directory structure is representative of IBM® MQ after a queue manager has been in use for some time. The actual structure that you have depends on which operations have occurred on the queue manager.

Default directory structure (UNIX and Linux) after a queue manager has been started.

/var/mqm/

The /var/mqm directory contains configuration files and output directories that apply to an IBM MQ installation as a whole, and not to an individual queue manager.

Table 1. Documented content of the /var/mqm directory on AIX and Linux
Directory or file name	Contents
mqs.ini	IBM MQ installation wide configuration file, read when a queue manager starts. File path modifiable using the AMQ_MQS_INI_LOCATION environment variable. Ensure this is set and exported in the shell in which the strmqm command is run.
mqclient.ini	Default client configuration file read by IBM MQ MQI client programs. File path modifiable using the MQCLNTCF environment variable.
service.env	Contains machine scope environment variables for a service process. File path fixed.
errors/	Machine scope error logs, and FFST files. Directory path fixed. See also, FFST: IBM MQ for UNIX and Linux systems.
sockets/	Contains information for each queue manager for system use only.
trace/	Trace files. Directory path fixed.
web/	mqweb server directory.
exits/	Default directory containing user channel exit programs. Location modifiable in ApiExit stanzas in the mqs.ini file.
exits64/

/var/mqm/qmgrs/`qmname`/

/var/mqm/qmgrs/qmname/ contains directories and files for a queue manager. The directory is locked for exclusive access by the active queue manager instance. The directory path is directly modifiable in the mqs.ini file, or by using the md option of the crtmqm command.

Table 2. Documented contents of the /var/mqm/qmgrs/`qmname` directory on AIX and Linux
Directory or file name	Contents
qm.ini	Queue manager configuration file, read when a queue manager starts.
errors/	Queue manager scope error logs. `qmname` `= @system` contains channel-related messages for an unknown or unavailable queue manager.
@ipcc/AMQCLCHL.TAB	Default client channel control table, created by the IBM MQ server, and read by IBM MQ MQI client programs. File path modifiable using the MQCHLLIB and MQCHLTAB environment variables.
qmanager	Queue manager object file: QMANAGER Queue manager object catalog: QMQMOBJCAT
authinfo/	Each object defined within the queue manager is associated with a file in these directories. The file name approximately matches the definition name; see, Understanding IBM MQ file names.
channel/
clntconn/
listener/
namelist/
procdef/
queues/
services/
topics/
...	Other directories used by IBM MQ, such as @ipcc, to be modified only by IBM MQ.
userdata/	Can be used to store the persistent state of applications (can be used by RDQM when moving queue managers to different nodes - see Storing persistent application status.)
`DataPath`\`autocfg`	Used for automatic configuration

/var/mqm/log/`qmname`/

/var/mqm/log/qmname/ contains the queue manager log files. The directory is locked for exclusive access by the active queue manager instance. The directory path is modifiable in the qm.ini file, or by using the ld option of the crtmqm command.

Table 3. Documented contents of the /var/mqm/log/`qmname` directory on AIX and Linux
Directory or file name	Contents
amqhlctl.lfh	Log control file.
active/	This directory contains the log files numbered S0000000.LOG, S0000001.LOG, S0000002.LOG, and so on.

/opt/mqm

/opt/mqm is, by default, the installation directory on most platforms. See Disk space requirements on Multiplatforms for more information on the amount of space that you need for the installation directory on the platform, or platforms, that your enterprise uses.