Distinguished Subject Names with Special Meaning

Copyright © Cloud Software Group, Inc. All Rights Reserved

Chapter 5 Subject Names : Distinguished Subject Names with Special Meaning

Distinguished Subject Names with Special Meaning

Names that begin with an underscore character (_) are called distinguished subject names. Distinguished names indicate special meaning, special handling, or restricted use.

Table 12 Distinguished Subject Names

Prefix

Description

_INBOX.

All inbox names begin with this prefix.

Programs may not create inbox names except with inbox creation calls. Programs cannot combine inbox names with wildcards.

Programs must treat inbox names as opaque, not modify them, and refrain from making inferences based on the form of inbox names.

_LOCAL.

Messages with subject names that have this prefix are only visible and distributed to transports connected to the same Rendezvous daemon as the sender.

For example, a program listening to the subject _LOCAL.A.B.C receives all messages sent on subject _LOCAL.A.B.C from any transport connected to the same daemon. A Rendezvous daemon does not transmit messages with _LOCAL subjects beyond that daemon.

_RV.

Subject names with this prefix indicate advisory messages, including informational messages, warnings and errors. Programs must not send to subjects with this prefix. For a description of advisory messages, see Advisory Messages.

_

All other subject names that begin with an underscore character indicate internal administrative messages. Programs must not send to subjects with this prefix.

Prefix	Description
_INBOX.	All inbox names begin with this prefix. Programs may not create inbox names except with inbox creation calls. Programs cannot combine inbox names with wildcards. Programs must treat inbox names as opaque, not modify them, and refrain from making inferences based on the form of inbox names.
_LOCAL.	Messages with subject names that have this prefix are only visible and distributed to transports connected to the same Rendezvous daemon as the sender. For example, a program listening to the subject _LOCAL.A.B.C receives all messages sent on subject _LOCAL.A.B.C from any transport connected to the same daemon. A Rendezvous daemon does not transmit messages with _LOCAL subjects beyond that daemon.
_RV.	Subject names with this prefix indicate advisory messages, including informational messages, warnings and errors. Programs must not send to subjects with this prefix. For a description of advisory messages, see Advisory Messages.
_	All other subject names that begin with an underscore character indicate internal administrative messages. Programs must not send to subjects with this prefix.