WebSphere MQ naming restrictions
The naming restrictions for WebSphere MQ queues, queue managers, and queue-sharing groups are more restrictive than those that apply to equivalent objects in WebSphere Application Server. Use this information to help administer the WAS objects, so that the names of these objects can be passed successfully to and from WebSphere MQ.
Rules for naming WebSphere MQ objects
- A WebSphere MQ object cannot have the same name as any other object of the same type.
- Names in WebSphere MQ are case sensitive.
- In WebSphere MQ, the names of queues can have up to 48 characters. The names of queue managers can have also have up to 48 characters, except in the case of WebSphere MQ for z/OS , where both queue manager and queue sharing group names are limited to four non-blank characters.
- The character set to use for naming all WebSphere MQ objects is as follows:
- Uppercase A-Z
- Lowercase a-z (but there are restrictions on the use of lowercase letters for z/OS console support)
- Numerics 0-9
- Period (.)
- Forward slash (⁄).
- Underscore (_)
- Percent sign (%).
- Leading or embedded blanks are not allowed.
- Any structure to the names (for example, the use of the period or underscore) is not significant to the queue manager.
For further details, see the WebSphere MQ information center.
Related concepts
Foreign destinations and alias destinations Configurations that include WebSphere MQ How to address bus destinations and WebSphere MQ queues Common issues with all bus configurations
Related tasks
Create an alias destination on a bus Configure alias destination properties
Mapping destinations to and from WebSphere MQ queues, topics, and destinations WebSphere MQ library Reference topic