Queue uniform resource identifiers

The URI for a queue specifies the name of the queue; it can also specify one or more properties of the queue.

The URI for a queue begins with the sequence queue://, followed by the name of the queue; it might also include a list of name-value pairs that set the remaining queue properties.

For IBM MQ queues (but not for WebSphere Application Server default messaging provider queues), the queue manager on which the queue resides may be specified before the queue, with a / separating the queue manager name from the queue name.

If a queue manager is specified, then it must be the one to which XMS is directly connected for the connection using this queue, or it must be accessible from this queue. Remote queue managers are only supported for retrieving messages from queues, not for putting messages onto queues. For full details, refer to the IBM MQ queue manager documentation.

If no queue manager is specified, then the extra / separator is optional, and its presence or absence makes no difference to the definition of the queue.

The following queue definitions are all equivalent for a IBM MQ queue called QB on a queue manager called QM_A, to which XMS is directly connected:

queue://QB
queue:///QB
queue://QM_A/QB
Parent topic: Destinations


Related concepts