This section describes the steps required to install the MSMQ communication point.

The MSMQ communication point uses a JNI DLL to talk directly to the Windows® API to perform all MSMQ operations. The JNI library is written in C++, but has minimal code to perform the MSMQ operation, and translate any errors into Java exceptions.

Requirements

To install the MSMQ communication point you must have the following:

  • The MSMQ .jar file.
  • The VC 2010 SP1 redistributable libraries are required and must be installed prior to using the communication point. These seem to be pre-installed on Windows® XP and Vista, but not on server versions of Windows®.

  • MSMQ must be installed on the machine that Rhapsody is running on so that it has access to MQRT.dll, the MSMQ client library.

    The VC 2010 SP1 redistributable package and MSMQ must be installed on the Rhapsody box, even if the MSMQ server is on another machine.

  • MSMQ uses Windows® security so the user that Rhapsody is running as needs read / write access to the queue.
  • The MSMQ communication point is compatible with MSMQ 3, however:
    • There is no guarantee that it works on Windows® 2000 (MSMQ 2).
    • Transactions cannot be used to perform receive operations on remote queues for versions earlier than MSMQ 4 (Vista / 2008 Server).

Installing MSMQ

Install the VC 2010 SP1 Redistributable

  1. Download the VC 2010 SP1 redistributable package.
  2. Install the VC 2010 SP1 redistributable.

Install MSMQ on the Machine

  1. Install and configure MSMQ Server:
    1. From the Control Panel, launch the Add or Remove Programs screen (Programs and Features on Windows® Vista).
    2. Select the Add/Remove Windows Components command on the left side of the screen (Turn Windows Features on or off on Microsoft™ Vista). The Windows Components screen is displayed.
    3. In the Windows Components screen, select the Message Queuing checkbox, and then click the Next button to install MSMQ (if the Message Queuing checkbox is selected, MSMQ is installed).
  2. Create the message queues.
    You can create Public and Private Queues. A Public Queue is registered in the directory service and can be used by other messaging applications, whereas a private queue is registered on the local computer.
    1. From the Control Panel, launch the Administrative Tools screen.
    2. Select the Computer Management screen from the Administrative Tools screen.
    3. Expand the Services and Applications node.
    4. Expand the Message Queuing node.
    5. Right click on the Private Queue or Public Queue node and select the New command from the popup menu that is then displayed.

    6. Specify the Queue Name and select the Transactional checkbox if it is a transactional queue.

      The names assigned to the message queues are the names used when configuring the MSMQ communication point in the Rhapsody IDE.

      You can now use this Queue to post and receive messages.

  • Refer to online MSMQ documentation for instructions on the installation and configuration of MSMQ on other platforms.
  • Install the MSMQ HTTP support on both the sender and receiver if this protocol is to be used within the MSMQ communication point.
  • Refer to online MSMQ documentation for instructions on configuring MSDTC for interoperability with transactional remote reads.

Install the Communication Point

  1. Install the MSMQ .jar file to the modules directory <RhapsodyInstallDirectory>\Rhapsody\rhapsody\data\modules.
  2. Restart the Rhapsody Engine to view the MSMQ communication point.