Purpose

Adds a default subscriber to a queue.

Usage Note

A program can enqueue messages to a specific list of recipients or to the default list of subscribers. This operation will only succeed on queues that allow multiple consumers. This operation takes effect immediately and the containing transaction is committed. Enqueue requests that are executed after the completion of this call will reflect the new behavior.

Note that any string within the rule has to be quoted as shown below;

rule => 'PRIORITY <= 3 AND CORRID = ''FROM JAPAN'''

Note that these are all single quotation marks.

When a queue, queue table, or subscriber is created and if GLOBAL_TOPIC_ENABLED = TRUE, a corresponding LDAP entry is also created.