Directory content on UNIX 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 Plan file system support on Multiplatforms.

In Figure 1, the layout is representative of IBM MQ after a queue manager has been in use for some time. The actual structure that we have depends on which operations have occurred on the queue manager.

/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 UNIX

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 UNIX

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.

/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 UNIX

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.