WebSphere WebSphere Business Integration Message Service Clients for C/C++ Version 1.2.7 and .NET Version 1.2.6 Operating Systems: AIX, Linux, Solaris, Windows

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 WebSphere 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 WebSphere 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 WebSphere 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

The following is an example of queue definitions for C++:

ioQueue = session.createQueue("queue:///SYSTEM.DEFAULT.LOCAL.QUEUE");

The name of the queue manager is omitted. This is interpreted as the queue manager to which the owning connection is connected at the time when the Queue object is used.

The following example of C code connects to queue Q1 on queue manager HOST1.QM1, and causes all messages to be sent as nonpersistent and priority 5 messages:

rc = xmsDestCreate(
  "queue://HOST1.QM1/Q1?persistence=1&priority=5",
  &ioQueue);
Related concepts
Topic uniform resource identifiers
Temporary destinations
Related reference
Destination (for the C class)
Destination (for the C++ class)
IDestination (for the .NET interface)
Properties of Destination

Concept topic

Terms of Use | Rate this page

Last updated: 18 Jun 2008

© Copyright IBM Corporation 2005, 2008. All Rights Reserved.