Inbound MSMQ Adapter configuration information is organized into the following topics:
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 this table:
Table 61 Connectivity Map - Inbound - MSMQ Configuration
Name |
Description |
Required Value |
---|---|---|
Specifies the queue alias. A queue alias associates an ADs path and a user-defined string (alias) with a public, private, or direct single-element format name. To send or receive messages using a queue alias, MSMQ and the Active Directory service must be installed on the same computer as the Application Server. |
The queue alias. See Identifying an MSMQ Queue for more information. |
|
Specifies the format name of the queue. The format name is a string that uniquely identifies a queue by providing some connection details and the queue’s path. Different types of format names can be used to specify the way messages are routed, the type of destination, and the type of operation for which the queue is being opened. Configure your MQ security attributes to accept TCP and HTTP protocol. |
The public or private format name in the following manner:
|
|
Specifies the Microsoft Message Queue Name. |
The string name that identifies the queue. This is associated with the host name, so the value is entered as queuename, where queuename is the queue name. See Identifying an MSMQ Queue for more information. |
|
Specifies the MSMQ share mode (DENY_NONE or DENY_RECEIVE_SHARE). |
Select DENY_NONE or DENY_RECEIVE_SHARE. DENY_NONE is the configured default. |
|
Specifies the MSMQ Access Mode. Only RECEIVE_ACCESS is supported for inbound mode. |
RECEIVE_ACCESS |
|
Specifies the polling interval or frequency at which the adapter checks the queue for incoming messages (in milliseconds). |
A number indicating the polling interval in milliseconds. The configured default is 5000 (5 seconds). |
|
MSMQ Receive Action Code |
Specifies the MSMQ Receive Action code. Only ACTION_RECEIVE is supported for inbound mode. |
ACTION_RECEIVE |
Specifies the Microsoft Message Transaction Type. |
The string name that identifies the queue. This is associated with the host name, so the value is entered as queuename, where queuename is the queue name. |
Where to Go Next
Related Topics
About Configuring Java CAPS Adapter Connectivity Map Properties
Configuring Java CAPS Project Components for Communication Adapters
Configuring Java CAPS Environment Components for Communications Adapters
The MSMQ Adapter identifies an MSMQ Queue using the first available value of these three properties, in the following order:
MSMQ Queue Alias
MSMQ Format Name
MSMQ Queue Name
Where to Go Next
MSMQ Format Name and Host Name.
Related Topics
About Configuring Java CAPS Adapter Connectivity Map Properties
Configuring Java CAPS Project Components for Communication Adapters
Configuring Java CAPS Environment Components for Communications Adapters
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 ComputerName, 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.
The ComputerName 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 (see Pre Transfer (BatchFTP Connectivity Map)).
Where to Go Next
Configuring MSMQ Adapter Outbound Connectivity Map Properties.
Related Topics