Resolving problem: Telemetry (MQXR) service does not start

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

Before you begin

The WebSphere® 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 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.

About this task

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 IBM 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 IBM MQ Telemetry feature.
  2. Start the service; wait for 30 seconds; refresh the 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. Backup 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.