Defining the MQXR service manually on Windows

You can define the MQXR service manually by using IBM® MQ Explorer. A queue manager can have only one instance of the MQXR service defined.

Before you begin

  • Install the MQ Telemetry feature.

Procedure

  1. In the Navigator view, right-click the Services folder.
  2. Click New > Service to open the New Service Definition wizard.
  3. In the Name field, type SYSTEM.MQXR.SERVICE and click Next.
  4. In the Description field, type a description of the service (for example, Manages clients using MQXR protocols such as MQTT).
  5. Select an option from the Service control menu.
  6. In the Start command field, type +MQ_INSTALL_PATH+\mqxr\bin\runMQXRService.bat
  7. [MQ 9.3.0 Jun 2022]In the Start args field
    
    STARTARG('-m +QMNAME+ -d "+MQ_Q_MGR_DATA_PATH+" -g "+MQ_DATA_PATH+" -sf “c:\PathOfKeyFile” -sp 2')
    STARTARG('-m +QMNAME+ -d "+MQ_Q_MGR_DATA_PATH+" -g "+MQ_DATA_PATH+" -sf DEFAULT" -sp 2')
    
    where the -sp option specifies the protection mode. The default value is 2 to use the more secure credentials protection method.
  8. In the Stop command field, type +MQ_INSTALL_PATH+\mqxr\bin\endMQXRService.bat
  9. In the Stop args field, type -m +QMNAME+
  10. In the StdOut field, type +MQ_Q_MGR_DATA_PATH+\mqxr.stdout
  11. In the StdErr field, type +MQ_Q_MGR_DATA_PATH+\mqxr.stderr
  12. Select Server from the Service type menu.
  13. Click Finish.
    [MQ 9.3.0 Jun 2022]
    Note: In Step 7, the -sf option is for encrypting the passphrases of TLS channels. For more information, see Encrypting passphrases for MQTT TLS channels.

Results

The MQXR service is created.

To view the MQXR service in the Navigator view click the Services folder. Ensure the Show System Objects option is selected, and navigate to the service.

In this task, the service is called SYSTEM.MQXR.SERVICE.