Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 3 Destinations : Destination Name Syntax

Destination Name Syntax
TIBCO Enterprise Message Service places few restrictions on the syntax and interpretation of destination names. System designers and developers have the freedom to establish their own conventions when creating destination names. The best destination names reflect the structure of the data in the application itself.
Structure
A destination name is a string divided into elements, each element separated by the dot character (.). The dot character allows you to create multi-part destination names that categorize destinations.
Empty strings ("") are not permitted in destination names. Likewise, elements cannot incorporate the dot character by using an escape sequence.
Although they are not prohibited, we recommend that you do not use tabs, spaces, or any unprintable character in a destination name. You may, however, use wildcards. See Wildcards for more information.
Length
Destinations are limited to a total length of 249 characters. However, some of that length is reserved for internal use. The amount of space reserved for internal use varies according to the number of elements in the destination; destinations that include the maximum number of elements are limited to 196 characters.
A destination can have up to 64 elements. Each element cannot exceed 127 characters. Dot separators are not included in element length.
Destination Name Performance Considerations
When designing destination naming conventions, remember these performance considerations:
Special Characters in Destination Names
These characters have special meanings when used in destination names:
 
For more information on wildcard matching, see Wildcards * and >.
Examples
These examples illustrate the syntax for destination names.
 
 
WRONG. (null element)
.TRIPLE.WRONG.. (three null elements)
News.Tennis.Stats.Roger\.Federer (backslash in the element Roger will be included in the element name, and will not escape the dot)

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved