EMS Destination Properties

EMS Destination Properties

Authenticate users before giving access to a queue or topic. Only authenticated users can send or receive message from the secured destination.

Syntax: addprop [queue|topic] <<queue|topic name>> secure
Example: addprop topic topic.foo secure

Setting this property make a topic multicast. This property can be only set to a topic by which messages send to these topics are broadcasted.

Syntax: <<topic name>> channel=<<channel name>>

Example: topic.foo channel=mycast
Channels configuration details are stored in channels.conf

[Only for queue] By default the EMS server send the messages on a queue to the consumers in a round-robin fashion. By setting this property the message on the queue are send to only one consumer (Primary) and other consumers (Secondary) on the same queue are at standby.

If the primary consumer fails the standby consumer becomes primary.
This property can not be set to a topic or a global queue.
Exclusive property can be in case of fault tolerance
mode at consumer end.
Example: create queue.foo exclusive

The messages are destroyed or send to the undelivered queue if the message in not consumed within the time specified.
Syntax: setprop queue <<queue name>> expiration=time[msec|sec|min|hour|day]
Example: setprop queue foo expiration=10min

Server slows down the producers to the rate at which the consumer is receiving it if the specified max size used to store pending messages exceeds.
Syntax: setprop queue <<queue name>> flowcontrol=size[KB|MB|GB]
Example: setprop queue foo flowcontrol=10MB

Max size to store overall message in a queue or topic. Message are rejected on exceeding.
MaxBytes:
Syntax: setprop queue <<queue name>> maxbyte=size[KB|MB|GB]
Example: setprop queue foo maxbyte=10MB

MaxMsg:
Syntax: setprop queue <<queue name>> maxmsg=number
Example: setprop queue foo maxmsg=1000

Used to change the effect of max bytes and max message on exceeding the specified limit.

Properties that can be assigned:
Default:
For topics, default specifies if the maxbytes or maxmsgs setting has been reached, then that subscriber does not receive the message. No error is returned to the message producer.
For queues, default specifies that new messages are rejected by the server and an error is returned to the producer if the established maxbytes or maxmsgs value has been exceeded.

Discard Old: For queue and topic the oldest messages are discarded before they are delivered to the subscriber/consumer.
An error message is send to the producer incase of queue [EMS 6.0].
No error message is send to the producer in case of queue or topic [EMS 7.0].

Reject Incoming: For queue and topic the new messages are discarded before they are delivered to the subscriber/consumer and error message is send to the to the producer.

Enables tracing for a destination.

Syntax: addprop [queue|topic] <<queue|topic name>> trace
Example: addprop topic topic.foo trace

Allows messages published by an external system to be
received by a EMS destination (a topic or a queue), as long as the transport to the external system is configured.

Allows messages published by a client to a topic to be exported to the external systems with configured transports.