Home

 

Queue manager name transformation

 

In WebSphere 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:

   • . becomes !

   • ⁄ becomes &

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:

• In WebSphere MQ for Windows with NTFS or FAT32, the queue manager name becomes:

  c:\\IBM\WebSphere MQ\qmgrs\queue!manager

• In WebSphere MQ for Windows with FAT, the queue manager name becomes:

  c:\\IBM\WebSphere MQ\qmgrs\queue!ma

• In WebSphere MQ for UNIX systems, 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.

 

Parent topic:

Understanding WebSphere MQ file names

fa10770_

 

Home