Subject and Destination Names
An adapter instance sends and receives messages using subject names when using the TIBCO Rendezvous transport type, and destination names when using the JMS transport type. Both subject and destination names are structured strings of alphanumeric characters divided into elements by the dot (.) character. For example, Tibco.Tsi and News.Sports.Baseball are valid subject and destination names.
Default subject or destination names are provided in TIBCO Designer. You can change these default values to specify a custom subject or destination name. A default subject or destination name, depending on which transport type you choose to configure, is created each time an adapter service is created.
The following are restrictions on subject names and destination names:
| • | Length of subject and destination names |
| — | Subject names are limited to a total length of 255 characters (including the dot delimiters). Even though TIBCO Rendezvous has a 255-character subject length limit, it is very unlikely that applications will have to use the full length. If you want to run an adapter instance against Microsoft SQL Server, you must design your subject space to conform to the length restrictions. A maximum of 100 elements are supported in a subject name. The maximum element length is 127 characters. |
| • | Wildcard characters |
The asterisk (*) and greater than (>) symbols are wildcard characters that can be used when specifying subject names or destination names.
For example, if messages are published on the tsi.sales.sports and tsi.sales.clothing subjects and your subscriber adapter listens on the tsi.sales.* subject, the configuration will get messages sent on both subjects. This feature also applies to destination names.
| • | Reserved underscore (_) |
Subject or destination names beginning with underscore (_) are reserved. Application programs cannot send subjects or destinations with an underscore as the first character of the first element, however, _INBOX and _LOCAL are exceptions for subject names, and _INBOX is an exception for destination names. It is good practice not to use tabs, spaces, or any unprintable character.
An underscore can be used elsewhere in subject or destination names. Subject names are case sensitive.
| • | Empty strings |
Empty strings ("") cannot be used.
| • | Dot character |
The dot character cannot be incorporated into an element by using an escape sequence.
See TIBCO Rendezvous Concepts for a full explanation of subject names and TIBCO Enterprise Message Service User’s Guide for destination names.