Rules for naming WebSphere MQ objects
WebSphere MQ authentication
information, channel, client channel, listener, namelist, process, queue,
service and storage class objects exist in separate object name spaces, and so objects from each type can all have the same name.
However, an object cannot have the same name as any other object in the same
name space. (For example, a local queue cannot have the same name as a model
queue.) Names in WebSphere MQ are case sensitive; however, you should remember that
lowercase characters that are not contained within quotation marks are folded
to uppercase.
The character set that can be used for naming all WebSphere MQ objects is as follows:
- Uppercase A-Z
- Lowercase a-z (however, on systems using EBCDIC Katakana you cannot
use lowercase characters, and there are also restrictions on the use of lowercase
letters for z/OS console support)
- Numerics 0-9
- Period (.)
- Forward slash (/)
- Underscore (_)
- Percent sign (%). The percent sign (%) is a special character
to RACF(R). If you are using RACF as the external security manager for WebSphere MQ for z/OS,
you should not use % in object names. If you do, these names are
not included in any security checks when RACF generic profiles are used.
Notes:
- Leading or embedded blanks are not allowed.
- Avoid using names with leading or trailing underscores, because they cannot
be handled by the WebSphere MQ for z/OS operations and control panels.
- Any name that is less than the full field length can be padded to the
right with blanks. All short names that are returned by the queue manager
are always padded to the right with blanks.
- Any structure to the names (for example, the use of the period or underscore)
is not significant to the queue manager.
- When using CL commands or menus on i5/OS systems, lowercase a-z, forward
slash (/), and percent (%) are special characters. If you use
any of these characters in a name, the name must be enclosed in quotation
marks. Lowercase a-z characters are changed to uppercase if the name is not
enclosed in quotation marks.