Knowledge Base:
I receive an error message when trying to open Handheld Contact. It says: "Unhandled Exception occurred: Message Queuing is not installed or running on this PC".
Posted by Craig S, Last modified by Craig S on 02 May 2025 08:56 PM

In order to correct this error, you need to manually install the Message Queuing Service.  Please follow the steps below for your corresponding operating system:

Note:  The installation of Message Queuing should not require a restart of the PC/server.  If this is prompted, there are issues with the install process of Microsoft Message Queuing and would need to be addressed separately.

A separate resource that contains install directions for Windows 10/11 as well as Server 2012/2012 R2/2016/2019/2022 can be found here.

  

Windows 10:

  1. From the Desktop, click on Start Menu.
  2. Choose Settings.
  3. Select System.
  4. In the Search bar in the upper right corner, type out 'Windows features'.
  5. Along the left side click on the option for Turn Windows features on or off.
  6. In the Windows Features dialog box, expand the first option for Microsoft Message Queue (MSMQ) Server.
  7. Click on the box that is labelled ‘Microsoft Message Queue (MSMQ) Server Core’.  The box should get filled in with a solid color. 
  8. Click OK to begin the installation.
  9. Restart the HHC Services by clicking here.

 

Windows Server 2012:

  1. From the Start screen, select Server Manager.
  2. In the Server Manager dialog box, select Add Roles and Features from the center pane.
  3. In the Add Features Wizard, click Next.
  4. Determine the Installation Type relevant to your setup. Click Next.
  5. Select the server you are going to install your Workflow Server and/or Subscriber on. Click Next.
  6. Click Next on the Server Roles page.
  7. At the Select Features step, expand Message Queuing and Message Queuing Services.
  8. Select Message Queuing Server.

Note: The minimum feature required for Microsoft Message Queuing on Windows Server 2012 is Message Queuing Server.

  1. Click Next, then Install.
  2. Click Close when the installation finishes.  Restart the HHC Services by clicking here.

 

Windows Server 2016 or later:

  1. From the Start menu, choose Server Manager.
  2. In the Server Manager, go to Manage then choose Add Roles and Features.
  3. On the Before You Begin screen, click Next.
  4. Select Role-based or feature-based installation and click Next.
  5. Select the server where to install the feature.
  6. Go to Features and navigate to Message Queuing, then Message Queuing Services and select Message Queuing Server.
  7. Click Install to begin installation.
  8. The setup may require a system restart.  Click OK to finish.
  9. Restart the HHC Services by clicking here.