IBM Support

IBM MQ 9.0.0 running on Windows: IBM MQ Explorer does not start after removing Fix Pack.

Troubleshooting


Problem

This issue is seen with the following fix packs on Windows systems:

  • After removing IBM MQ Fix Pack 9.0.0.12 to return it to the 9.0.0.11 level.
  • After removing IBM MQ Fix Pack 9.0.0.2 to return it to the 9.0.0.1 level.

In the IBM MQ Explorer log, the following exception is reported:

!ENTRY org.eclipse.osgi 4 0 2017-09-28 12:14:38.616
!MESSAGE Application error
!STACK 1 java.lang.RuntimeException: Application "com.ibm.mq.explorer.ui.rcp.RcpApplication" could not be found in the registry. The applications available are: org.eclipse.ant.core.antRunner, org.eclipse.e4.ui.workbench.swt.E4Application, org.eclipse.e4.ui.workbench.swt.GenTopic, org.eclipse.equinox.app.error, org.eclipse.equinox.p2.garbagecollector.application, org.eclipse.equinox.p2.publisher.InstallPublisher, org.eclipse.equinox.p2.publisher.EclipseGenerator, org.eclipse.equinox.p2.publisher.ProductPublisher, org.eclipse.equinox.p2.publisher.FeaturesAndBundlesPublisher, org.eclipse.equinox.p2.reconciler.application, org.eclipse.help.base.infocenterApplication, org.eclipse.help.base.helpApplication, org.eclipse.help.base.indexTool, org.eclipse.ui.ide.workbench.
at org.eclipse.equinox.internal.app.EclipseAppContainer.startDefaultApp(EclipseAppContainer.java:248)
at org.eclipse.equinox.internal.app.MainApplicationLauncher.run(MainApplicationLauncher.java:29)
at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.runApplication(EclipseAppLauncher.java:134)
at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.start(EclipseAppLauncher.java:104)
at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:380)
at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:235)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:95)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:55)
at java.lang.reflect.Method.invoke(Method.java:508)
at org.eclipse.equinox.launcher.Main.invokeFramework(Main.java:648)
at org.eclipse.equinox.launcher.Main.basicRun(Main.java:603)
at org.eclipse.equinox.launcher.Main.run(Main.java:1465)

The log also contains lots of errors indicating that the required bundle com.ibm.mq.osgi.allclient cannot be resolved. Here is an example of these errors:

!ENTRY com.ibm.mq.explorer.ams 4 0
!MESSAGE FrameworkEvent ERROR
!STACK 0 org.osgi.framework.BundleException: Could not resolve module: com.ibm.mq.explorer.ams [510] Unresolved requirement: Require-Bundle: com.ibm.mq.osgi.allclient
at org.eclipse.osgi.container.Module.start(Module.java:434)
at org.eclipse.osgi.container.ModuleContainer$ContainerStartLevel.incStartLevel(ModuleContainer.java:1582)
at org.eclipse.osgi.container.ModuleContainer$ContainerStartLevel.incStartLevel(ModuleContainer.java:1561)
at org.eclipse.osgi.container.ModuleContainer$ContainerStartLevel.doContainerStartLevel(ModuleContainer.java:1533)
at org.eclipse.osgi.container.ModuleContainer$ContainerStartLevel.dispatchEvent(ModuleContainer.java:1476)
at org.eclipse.osgi.container.ModuleContainer$ContainerStartLevel.dispatchEvent(ModuleContainer.java:1)
at org.eclipse.osgi.framework.eventmgr.EventManager.dispatchEvent(EventManager.java:230)
at org.eclipse.osgi.framework.eventmgr.EventManager$EventThread.run(EventManager.java:340)

Resolving The Problem

To resolve this issue, update the following file to include entries for all of the plugins required by IBM MQ Explorer:
<MQ_Installation_Path>\MQExplorer\eclipse\configuration\org.eclipse.equinox.simpleconfigurator\bundles.info

The entries to add to the file are as follows:

Fix Pack

Entries to add to the bundles.info file

9.0.0.11

com.ibm.mq.osgi.allclient,9.0.0.11,plugins/com.ibm.mq.osgi.allclient_9.0.0.11.jar,4,false
com.ibm.mq.osgi.allclientprereqs,9.0.0.11,plugins/com.ibm.mq.osgi.allclientprereqs_9.0.0.11.jar,4,false

9.0.0.1

com.ibm.mq.osgi.allclient,9.0.0.1,plugins/com.ibm.mq.osgi.allclient_9.0.0.1.jar,4,false
com.ibm.mq.osgi.allclientprereqs,9.0.0.1,plugins/com.ibm.mq.osgi.allclientprereqs_9.0.0.1.jar,4,false


After updating the bundles.info file, restart IBM MQ Explorer.

[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"ARM Category":[{"code":"a8m0z00000008MGAAY","label":"Install \/ Uninstall"}],"ARM Case Number":"","Platform":[{"code":"PF033","label":"Windows"}],"Version":"9.0.0"}]

Document Information

Modified date:
29 October 2021

UID

swg22009137