Resolving problem: Telemetry (MQXR) service does not start

Resolve the problem of the telemetry (MQXR) service failing to start. Check the MQ Telemetry installation and no files are missing, moved, or have the wrong permissions. Check the paths that are used by the telemetry (MQXR) service locate the telemetry (MQXR) service programs.

Before starting

The MQ Telemetry feature is installed. The IBM MQ Explorer has a Telemetry folder in IBM MQ > Queue Managers > qMgrName > Telemetry. If the folder does not exist, the installation has failed.

The Telemetry (MQXR) service must have been created for it to start. If the telemetry (MQXR) service has not been created, then run the Define sample configuration... wizard in the Telemetry folder.

If the telemetry (MQXR) service has been started before, then additional Channels and Channel Status folders are created under the Telemetry folder. The Telemetry service, SYSTEM.MQXR.SERVICE, is in the Services folder. It is visible if the IBM MQ Explorer radio button to show System Objects is clicked.

Right-click SYSTEM.MQXR.SERVICE to start and stop the service, show its status, and display whether your user ID has authority to start the service.

The SYSTEM.MQXR.SERVICE telemetry (MQXR) service fails to start. A failure to start manifests itself in two different ways:

1. The start command fails immediately.
2. The start command succeeds, and is immediately followed by the service stopping.

Procedure

1. Start the service.

   Result

   The service stops immediately. A window displays an error message; for example:

   IBM MQ cannot process the request because the
   executable specified cannot be started. (AMQ4160)
   

   Reason

   • Files are missing from the installation, or the permissions on installed files are set wrongly.
   • The MQ Telemetry feature is installed only on one of a pair of highly available queue managers. If the queue manager instance switches over to a standby, it tries to start SYSTEM.MQXR.SERVICE. The command to start the service fails because the telemetry (MQXR) service is not installed on the standby.

   Investigation

   Look in error logs; see Server-side logs.

   Actions

   Install, or uninstall and reinstall the MQ Telemetry feature.

2. Start the service; wait for 30 seconds; refresh the IBM MQ Explorer and check the service status.

   Result

   The service starts and then stops.

   Reason

   SYSTEM.MQXR.SERVICE started the runMQXRService command, but the command failed.

   Investigation

   • Look in error logs; see Server-side logs.
   • See if the problem occurs with only the sample channel defined. Back up and the clear the contents of the WMQ data directory\Qmgrs\qMgrName\mqxr\ directory. Run the sample configuration wizard and try to start the service.

   Actions

   Look for permission and path problems.

Parent topic: MQ Telemetry troubleshooting