Progress Sonic 8.5 Installation and Upgrade Guide - Product ...

Appendix A: Characters in Progress Sonic Names
Table 14. Naming Rules and Allowed Characters in Sonic (continued)
Configuration Name
Topic 256 All alphanumeric characters, ASCII punctuation and symbols are allowed
except backslash (\) and dollar sign ($).
Note that:
● Asterisk (*) and pound sign (#) have wildcard meaning.
● Colon (:) is reserved for a remote topic name.
● Adjacent colons (::) are reserved for delimiting sections of global
routing names.
● Double brackets ([[ ]]) enclose a shared subscription identifier.
● Names that begin the character string “SonicMQ” are reserved for
system use.
● Slash (/) is allowed in client applications to designate an HTTP(S)
protocol for a URL. The slash character should be avoided in
configurations; starting a topic name with http:// or https:// in a
configuration will result in a topic that applications cannot access.
User
(internal or external)
Max
Size Allowed Characters and Special Use
- All alphanumeric characters, ASCII punctuation and symbols are allowed
except asterisk (*), pound (#), dollar sign ($), slash (/), and backslash (\).
Important Characters in installation location names — The installer does not accept some
characters that, while acceptable as folder names on the target platform, can create
problems in evaluation of names in SonicMQ and the Sonic ESB product family.
The filtered characters are: ampersand (&), semicolon(;), caret (^), equal sign (=),
plus sign (+), comma (,), tilde (~), bang (!), at sign (@), pound (#), dollar sign ($),
percent (%), open/close parentheses (( )), open/close brackets ([ ]), and open/close
braces ({ }).
While spaces in names are not filtered, a good practice is to avoid spaces, using an
underscore (_) as a separator, such as my_folder/my_subfolder.
Uppercase and camelCase in names is valid but you can minimize potential issues on
disparate platforms by maintaining all names in lowercase.
230 Progress Sonic Installation and Upgrade Guide 8.5