Appendix C. Directory structure (UNIX systems)

Figure 36 shows the general layout of the data and log directories associated with a specific queue manager. The directories shown apply to the default installation. If you change this, the locations of the files and directories are modified accordingly. For information about the location of the product files, see one of the following:

In Figure 36, the layout is representative of WebSphere 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 36. Default directory structure (UNIX systems) after a queue manager has been started
 Default directory structure after a queue manager has been started (UNIX(R) systems).

By default, the following directories and files are located in the directory /var/mqm/qmgrs/qmname/ (where qmname is the name of the queue manager).

Table 36. Default content of a /var/mqm/qmgrs/qmname/ directory on UNIX systems
amqalchk.fil Checkpoint file containing information about the last checkpoint.
auth/ Contained subdirectories and files associated with authority in WebSphere MQ prior to Version 6.0.
authinfo/ Each WebSphere MQ authentication information definition is associated with a file in this directory. The file name matches the authentication information definition name--subject to certain restrictions; see Understanding WebSphere MQ file names.
channel/ Each WebSphere MQ channel definition is associated with a file in this directory. The file name matches the channel definition name--subject to certain restrictions; see Understanding WebSphere MQ file names.
clntconn/ Each WebSphere MQ client connection channel definition is associated with a file in this directory. The file name matches the client connection channel definition name--subject to certain restrictions; see Understanding WebSphere MQ file names.
dce/ Used for DCE support prior to WebSphere MQ Version 6.0.
errors/ Directory containing FFSTs, client application errors, and operator message files from newest to oldest:
  • AMQERR01.LOG
  • AMQERR02.LOG
  • AMQERR03.LOG
esem/ Directory containing files used internally.
isem/ Directory containing files used internally.
listener/ Each WebSphere MQ listener definition is associated with a file in this directory. The file name matches the listener definition name--subject to certain restrictions; see Understanding WebSphere MQ file names.
msem/ Directory containing files used internally.
namelist/ Each WebSphere MQ namelist definition is associated with a file in this directory. The file name matches the namelist definition name--subject to certain restrictions; see Understanding WebSphere MQ file names.
plugcomp/ Empty directory reserved for use by installable services.
procdef/ Each WebSphere MQ process definition is associated with a file in this directory. The file name matches the process definition name--subject to certain restrictions; see Understanding WebSphere MQ file names.
qmanager/
QMANAGER
The queue manager object.
QMQMOBJCAT
The object catalog containing the list of all WebSphere MQ objects; used internally.
qm.ini Queue manager configuration file.
queues/ Each queue has a directory in here containing a single file called q.

The file name matches the queue name, subject to certain restrictions; see Understanding WebSphere MQ file names.

services/ Each WebSphere MQ service definition is associated with a file in this directory. The file name matches the service definition name--subject to certain restrictions; see Understanding WebSphere MQ file names.
shmem/ Directory containing files used internally.
spipe/ Used internally by channel processes.
ssem/ Directory containing files used internally.
ssl/ Directory for SSL key database files.
startprm/ Directory containing temporary files used internally.
zsocketapp/ Used internally for isolated bindings.
zsocketEC/ Used internally for isolated bindings.
@ipcc/
AMQCLCHL.TAB
Client channel table file.
esem/
Directory containing files used internally.
isem/
Directory containing files used internally.
msem/
Directory containing files used internally.
shmem/
Directory containing files used internally.
ssem/
Directory containing files used internally.
@qmpersist
esem/
Directory containing files used internally.
isem/
Directory containing files used internally.
msem/
Directory containing files used internally.
shmem/
Directory containing files used internally.
ssem/
Directory containing files used internally.
@qmpersist
esem/
Directory containing files used internally.
isem/
Directory containing files used internally.
msem/
Directory containing files used internally.
shmem/
Directory containing files used internally.
ssem/
Directory containing files used internally.
@app
esem/
Directory containing files used internally.
isem/
Directory containing files used internally.
msem/
Directory containing files used internally.
shmem/
Directory containing files used internally.
ssem/
Directory containing files used internally.

By default, the following directories and files are found in /var/mqm/log/qmname/ (where qmname is the name of the queue manager).

The following subdirectories and files exist after you have installed WebSphere MQ, created and started a queue manager, and have been using that queue manager for some time.

amqhlctl.lfh Log control file.
active/ This directory contains the log files numbered S0000000.LOG, S0000001.LOG, S0000002.LOG, and so on.