Naming IBM MQ objects

The naming convention adopted for IBM MQ objects depends on the object. The name of the machines and the user IDs that we use with IBM MQ are also subject to some naming restrictions.

Each instance of a queue manager is known by its name. This name must be unique within the network of interconnected queue managers, so that one queue manager can unambiguously identify the target queue manager to which any given message is sent.

For the other types of object, each object has a name associated with it and can be referred to by that name. These names must be unique within one queue manager and object type. For example, we can have a queue and a process with the same name, but we cannot have two queues with the same name.

In IBM MQ, names can have a maximum of 48 characters, with the exception of channels which have a maximum of 20 characters. For more information about naming IBM MQ objects, see Rules for naming IBM MQ objects.

The name of the machines and the user IDs that we use with IBM MQ are also subject to some naming restrictions:

  • Ensure that the machine name does not contain any spaces. IBM MQ does not support machine names that include spaces. If we install IBM MQ on such a machine, we cannot create any queue managers.
  • For IBM MQ authorizations, names of user IDs and groups must be no longer than 20 characters (spaces are not allowed).
  • An IBM MQ for Windows server does not support the connection of a Windows client if the client is running under a user ID that contains the @ character, for example, abc@d.

  • Rules for naming IBM MQ objects
    IBM MQ object names have maximum lengths and are case-sensitive. Not all characters are supported for every object type, and many objects have rules concerning the uniqueness of names.
  • 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.
  • Object names on IBM i
    A queue manager has an associated queue manager library that has a unique name. Queue manager names and object names might need to be transformed to meet the requirements of the IBM i Integrated File System (IFS).

Parent topic: IBM MQ objects


Related concepts


Related reference