Opening Multiple Queues

 

Applies To: Windows 10, Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Server Technical Preview, Windows Vista

Message Queuing (MSMQ 3.0 only) provides distribution list and multiple-element format names for sending a message to multiple destination queues. These format names can be used to open any number of queues with send access (Message Queuing returns an error if an attempt is made to open multiple queues with peek or receive access).

Distribution List Format Names

Distribution list format names contain the GUID identifier of the distribution list object that is stored in the directory service. (Distribution lists are public lists stored in the directory service.) A distribution list can contain any number of public queues, queue aliases (queue aliases can be used to include private queues and URL-named queues), and other distribution lists.

Multiple-Element Format Names

Multiple-element format names are extension of the single element format names used to send one message to one destination queue. They are a concatenation of one or more public format names, private format names, direct format names, or distribution lists.

Unlike distribution lists, multiple-element format names are not stored in Active Directory Domain Services (AD DS) and must be created and maintained by the application that is sending the messages.

Programming Tips

When using distribution lists and multiple-element format names, consider the following issues:

  • Messages sent to multiple destination all have the same message identifier. For example, if a message is sent to three destination queues the message identifier of all three messages in the queues will be the same.

  • Do not include format names for read-only queues such queue journals, computer journals, or dead-letter queues. An error is returned if the format name of a read-only queue is included in a distribution lists or multiple-element format name.

  • Distribution lists and multiple-element format names may contain multiple references to the same destination. However, the source queue manager ignores duplicate references when it opens the destinations for sending messages. For example, if distribution list D1 explicitly specifies Q1 plus another distribution list D2, it may be possible that distribution list D2 also contains Q1 or D1. In this case, the duplicate Q1 and D1 references in distribution list D2 are ignored by the queue manager.

More Information

For information on See
Distribution list name syntax Distribution List Format Names
Multiple-element name syntax Multiple-Element Format Names
Sending messages to multiple queues Multiple-Destination Messaging