Specifying Use of MSMQ

To specify that you use MSMQ, rather than the TCP/IP transport, you use a special URL, that specifies the request queue name and the machine hosting the request queue. The URL begins with 'x-msmq' rather than the current 'x-ratl'.

The following description is an extract from the Class Reference documentation on the URL format:

The server is specified using a special URL of the form:

x-msmq:queue name

The queue name is a valid MSMQ name, and generally is of the form:

format:= machine name:queue name

The format for MSMQ connections is:

"x-msmq:[Format]:[HostName or IP Address of MSMQ server]:[Queue Name]”

For example, DIRECT=OS:ACUSMQ:PRIVATE$\DWTESTQ

the full parameter would be x-msmq:DIRECT=OS:ACUSMQ:PRIVATE$\DWTESTQ

The above is an example of a direct, private queue on the ACUSMQ machine. Such queues do not need to be looked up on the MSMQ server, and hence are quicker. Note however, that such queues do not benefit from the store and forward capabilities of public MSMQ and are really only suitable for Client to Business type applications, where turnaround time of the messages are important.

For Business to Business, where replies can take hours to days, you might want to use the full power of public MSMQ queues. (public queues omit the 'PRIVATE$\' from the queue name)

Notes:

  • DIRECT queues are recommended as they avoid the overhead of a queue name lookup from directory services and MSMQ store and forward operations as messages are sent DIRECTLY to the machine hosting the queue.

    Valid direct formats are:

    • DIRECT=OS - uses native machine naming convention

      For example, DIRECT=OS:MachineName\QueueName

    • DIRECT=SPX - connection-orientated SPX over IPX

      For example, DIRECT=SPX:NetworkNumber;HostNumber\QueueName

    • DIRECT=TCP - connection-orientated TCP over IP

      For example, DIRECT=TCP:IPAddress\QueueName

    You can choose the format appropriate for your situation.

  • The queue name can be a public or private queue on the MSMQ server. Using private queues is recommend, as they have less overhead in processing, and should be faster.

You should choose the format appropriate for your situation.