MSMQ Adapter Inbound Connectivity Map Properties

Inbound MSMQ Adapter configuration information is organized into the following topics:

• MSMQ Adapter Inbound Connectivity Map Properties

• Identifying an MSMQ Queue

• MSMQ Format Name and Host Name

MSMQ Adapter Inbound Connectivity Map Properties

When use one of these properties, for example Format Name, to identify a queue, recommend that you leave the value for the other two properties blank (in this case, you would leave the MSMQ Queue Alias and MSMQ Queue Name properties blank). This ensures that only the queue identification method you specify is used.

The MSMQ Configuration section of the inbound MSMQ Connectivity Map properties contains the top-level parameters displayed in the following table.

Table 25 Connectivity Map - Inbound - MSMQ Configuration

Identifying an MSMQ Queue

The MSMQ Adapter identifies an MSMQ Queue using the first available value of these three properties, in the following order:

1. MSMQ Queue Alias

2. MSMQ Format Name

3. MSMQ Queue Name

MSMQ Format Name and Host Name

The format name is a string that uniquely identifies a queue using connection details and the queue’s path. Different types of format names can be used to specify how messages are routed, the type of destination, and the type of operation for which the queue is being opened.

The public or private format name property value is entered in the following manner:

For public queues use the following:

• DIRECT=TCP:IPAddress\QueueName

  for example: DIRECT=TCP:192.168.100.100\testmsmq

  • DIRECT=OS:ComputerName\QueueName

    for example: DIRECT=OS:mypc-gx600\testmsmq

  • DIRECT=HTTP://Host/msmq/QueueName

    for example: DIRECT=HTTP://mypc-gx600/msmq/testmsmq

    For private queues use the following:

  • DIRECT=TCP:IPAddress\private$\QueueNamefor example: DIRECT=TCP:192.168.100.100\private$\privateqnxa

  • DIRECT=OS:ComputerName\private$\QueueName

    for example: DIRECT=OS:mypc-gx600\private$\privateqnxa

    Configure your MQ security attributes to accept TCP and HTTP protocol. If you specify an MSMQ Format Name, the MSMQ Queue Name and MSMQ Queue Alias properties must be left blank.

    To find the Computer Name, right-click My Computer and click Manage. From the Computer Management dialog box, select Computer Management ⇒ Services and Applications ⇒ Message Queueing ⇒ Public Queues. Right-click your queue and select Properties. From the General tab of the Properties dialog box, you can see the computer name and queue name used by MSMQ.

    ---

    Note - The Computer Name and Host Name is limited to 15 characters by MSMQ. If the Host Name contains more than 15 characters, MSMQ will truncate the name. In this case, you must use the truncated Host Name. Refer to the queue Properties, General tab to see the specific Host Name for your system.

    ---