This topic contains sections marked as revised for this release

WebSphere Message Brokers
File: an07070_
Writer: Bill Oppenheimer

Reference topic

This build: July 31, 2007 21:33:24

Characters allowed in commands

You must adhere to a few rules when you provide names or identifiers for the components and resources in your broker domain.

The character set that you can use to name brokers, Configuration Managers, execution groups, and message identifiers is as follows:
  • Uppercase alphabetic characters A-Z
  • Lowercase alphabetic characters a-z
  • Numeric characters 0-9
  • Any special characters supported by the underlying file system:
    • The following special characters are accepted on Windows platforms:
      $ % ' (apostrophe) " (quotation mark)
      - (dash) _ (underscore) @ ~ (tilde)
      ! ( ) {
      } [ ] &
      # & + , (comma)
      ; =  (space)  
    • The following special characters, with the exception of a space, are accepted on Linux and UNIX platforms:
      . (dot) % - (dash) _ (underscore)
      @ ~ (tilde) ! {
      } [ ] &
      # , (comma) =  (space)

    In general, you can use characters A through Z, a through z, and 0 through 9, plus any Unicode character with a decimal value greater than 127 (hexadecimal X'7F'), provided that your operating system can recognize the characters chosen.

    If you expect to trace the operation of an execution group, restrict the name of the execution group to include only the valid alphabetic and numeric characters listed. The trace commands do not support the use of special characters for an execution group name.

For all other resources (User Name Server, message sets, message flows, and topics), any characters that are supported by the database configuration are supported.

On Windows platforms, broker names, Configuration Manager names, and fixed names ( UserNameServer) are not case sensitive. For example, broker names Broker1 and BROKER1 refer to the same broker.

On Linux and UNIX systems, broker names and Configuration Manager names are case sensitive, and the examples above would refer to different brokers. You must use UserNameServer as shown.

On z/OS systems, you must enclose mixed-case names in quotation marks.

There are additional rules for naming message service folders within the MQRFH2 header.

Related reference
Message service folders
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:33:24

an07070_ This topic's URL is: