IBM MQ file names

Each IBM MQ queue manager, queue, process definition, namelist, channel, client connection channel, listener, service, and authentication information object is represented by a file. Because object names are not necessarily valid file names, the queue manager converts the object name into a valid file name where necessary.

The default path to a queue manager directory is as follows:

• A prefix, which is defined in the IBM MQ configuration information:
  • On Windows 32-bit systems, the default prefix is C:\Program Files (x86)\IBM\WebSphere MQ. On Windows 64-bit systems, the default prefix is C:\Program Files\IBM\MQ. For both 32-bit and 64-bit installations, the data directories are installed into C:\ProgramData\IBM\MQ. This is configured in the DefaultPrefix stanza of the mqs.ini configuration file.
  • On UNIX and Linux, the default prefix is /var/mqm. This is configured in the DefaultPrefix stanza of the mqs.ini configuration file.

  Where available, the prefix can be changed using the IBM MQ properties page in the IBM MQ Explorer, otherwise edit the mqs.ini configuration file manually.

• The queue manager name is transformed into a valid directory name. For example, the queue manager:

  queue.manager
  

  would be represented as:

  queue!manager
  

  This process is referred to as name transformation.

In IBM MQ, we can give a queue manager a name containing up to 48 characters.

For example, you could name a queue manager:

QUEUE.MANAGER.ACCOUNTING.SERVICES

However, each queue manager is represented by a file and there are limitations on the maximum length of a file name, and on the characters that can be used in the name. As a result, the names of files representing objects are automatically transformed to meet the requirements of the file system.

The rules governing the transformation of a queue manager name are as follows:

1. Transform individual characters:
   • From . to !
   • From / to &

2. If the name is still not valid:
   1. Truncate it to eight characters
   2. Append a three-character numeric suffix

For example, assuming the default prefix and a queue manager with the name queue.manager:

• On Windows with NTFS or FAT32, the queue manager name becomes:

  C:\Program Files\IBM\MQ\qmgrs\queue!manager
  

• On Windows with FAT, the queue manager name becomes:

  C:\Program Files\IBM\MQ\qmgrs\queue!ma
  

• On UNIX and Linux, the queue manager name becomes:

  /var/mqm/qmgrs/queue!manager
  

The transformation algorithm also distinguishes between names that differ only in case on file systems that are not case sensitive.

Object name transformation

Object names are not necessarily valid file system names. We might need to transform your object names. The method used is different from that for queue manager names because, although there are only a few queue manager names on each machine, there can be a large number of other objects for each queue manager. Queues, process definitions, namelists, channels, client connection channels, listeners, services, and authentication information objects are represented in the file system.

When a new name is generated by the transformation process, there is no simple relationship with the original object name. We can use the dspmqfls command to convert between real and transformed object names.

Parent topic: Naming IBM MQ objects

Related information

• dspmqfls (display file names)