Configuring Java CAPS Project Components for Communication Adapters

Configuring MSMQ Adapter Inbound Connectivity Map Properties

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

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 this table:

Table 61 Connectivity Map - Inbound - MSMQ Configuration


Name	Description	Required Value
MSMQ Queue Alias	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.
MSMQ Format Name	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: For public queues use the following: DIRECT=TCP: `IPAddress\QueueName` DIRECT=OS: `ComputerName\QueueName` DIRECT=HTTP: `//Host/msmq/QueueName` For private queues use the following: DIRECT=TCP: `IPAddress\private$\QueueName` DIRECT=`OS:ComputerName\` `private$\QueueName` Configure your MQ security attributes to accept TCP and HTTP protocol. For examples of both public and private MSMQ Format Names, see Pre Transfer (BatchFTP Connectivity Map). Note – If the ComputerName or Host name contains more than 15 characters, MSMQ will truncate the name. In this case, you must use the truncated ComputerName. refer to the queue Properties, General tab to see the specific ComputerName for your system. See Pre Transfer (BatchFTP Connectivity Map) for more information. See Identifying an MSMQ Queue for more information.
MSMQ Queue Name	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.
MSMQ Share Mode	Specifies the MSMQ share mode (DENY_NONE or DENY_RECEIVE_SHARE).	Select DENY_NONE or DENY_RECEIVE_SHARE. DENY_NONE is the configured default.
MSMQ Access Mode	Specifies the MSMQ Access Mode. Only RECEIVE_ACCESS is supported for inbound mode.	RECEIVE_ACCESS
MSMQ Receive Interval	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
MSMQ Transaction Type	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

Identifying an MSMQ Queue

Related Topics

Identifying an MSMQ Queue

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

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 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.
  
  Note –
  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