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 the location of the product files, see Choosing an installation location

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

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 you have depends on which operations have occurred on the queue manager.
Figure 1. Default directory structure (UNIX systems) after a queue manager has been started
Default directory structure (UNIX systems) 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 UNIX systems
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/
sockets/
  • Contains information for each queue manager for system use only.
trace/
  • Trace files.
  • Directory path fixed.
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 systems
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 systems
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 distributed platforms for more information on the amount of space that you need for the installation directory on the platform, or platforms, that your enterprise uses.