APAR status
Closed as program error.
Error description
When using 'fteListAgents' command, a 'java.lang.NullPointerException' exception stack is reported instead of agent information, as follows: $ /opt/mqm/bin/fteListAgents 5724-H72 Copyright IBM Corp. 2008, 2018. ALL RIGHTS RESERVED Command executed at 2020-07-01 14:32:51 BST Coordination queue manager time 2020-07-01 13:32:52 UTC java.lang.NullPointerException at com.ibm.wmqfte.utils.AgentStatusDetails.getAgeOfAgentStatus(Agen tStatusDetails.java:1203) at com.ibm.wmqfte.api.ListAgents.displayResults(ListAgents.java:443 ) at com.ibm.wmqfte.api.ListAgents.main(ListAgents.java:308) at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessor Impl.java:90) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethod AccessorImpl.java:55) at java.lang.reflect.Method.invoke(Method.java:508) at com.ibm.wmqfte.agent.bootstrap.impl.BootstrapMain.run(BootstrapM ain.java:284) at com.ibm.wmqfte.agent.bootstrap.impl.BootstrapMain.main(Bootstrap Main.java:118)
Local fix
A workaround for this issue is to use the "-t" option to the 'fteListAgents' command, which prevents the status age from being displayed, avoiding the cause of the 'java.lang.NullPointerException'.
Problem summary
**************************************************************** USERS AFFECTED: This issue affects users of IBM MQ Managed File Transfer, who are running the command: fteListAgents It also affects users of the MQExplorer, who are connecting to their MFT topology. Platforms affected: MultiPlatform **************************************************************** PROBLEM DESCRIPTION: When a IBM MQ MFT topology included data from older IBM MQ releases that did not publish agent status age data to the Coordination queue manager's Topics, when the newer version of 'fteListAgents' command or IBM MQExplorer accessed the published data, it expected it to contain the agent status age. With it being absent, a 'java.lang.NullPointerException' was thrown instead of the expected agent listing being returned by the command. The Java exception stack output reported on the 'fteListAgents' command line was of the following form: $ /opt/mqm/bin/fteListAgents 5724-H72 Copyright IBM Corp. 2008, 2018. ALL RIGHTS RESERVED Command executed at 2020-07-01 14:32:51 BST Coordination queue manager time 2020-07-01 13:32:52 UTC java.lang.NullPointerException at com.ibm.wmqfte.utils.AgentStatusDetails.getAgeOfAgentStatus(Agen tStatusDetails.java:1203) at com.ibm.wmqfte.api.ListAgents.displayResults(ListAgents.java:443 ) at com.ibm.wmqfte.api.ListAgents.main(ListAgents.java:308) at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessor Impl.java:90) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethod AccessorImpl.java:55) at java.lang.reflect.Method.invoke(Method.java:508) at com.ibm.wmqfte.agent.bootstrap.impl.BootstrapMain.run(BootstrapM ain.java:284) at com.ibm.wmqfte.agent.bootstrap.impl.BootstrapMain.main(Bootstrap Main.java:118) Users of the IBM MQExplorer who connected to the Managed File Transfer Configuration would also encounter a 'java.lang.NullPointerException' dialog box, with a Java stack of the following form: !MESSAGE Problems occurred when invoking code from plug-in: "org.eclipse.jface". !STACK 0 java.lang.NullPointerException at com.ibm.wmqfte.utils.AgentStatusDetails.getAgeOfAgentStatus(Agen tStatusDetails.java:1203) at com.ibm.wmqfte.explorer.content.AgentStatusAgeLabelProvider.getT ext(AgentContentPage.java:1220) at org.eclipse.jface.viewers.ColumnLabelProvider.update(ColumnLabel Provider.java:34) at org.eclipse.jface.viewers.ViewerColumn.refresh(ViewerColumn.java :141) at org.eclipse.jface.viewers.AbstractTableViewer.doUpdateItem(Abstr actTableViewer.java:391) at org.eclipse.jface.viewers.StructuredViewer$UpdateItemSafeRunnabl e.run(StructuredViewer.java:475) at org.eclipse.core.runtime.SafeRunner.run(SafeRunner.java:42) at org.eclipse.ui.internal.JFaceUtil.lambda$0(JFaceUtil.java:44) at org.eclipse.ui.internal.JFaceUtil$$Lambda$8/000000008C53CDE0.run (Unknown Source) at org.eclipse.jface.util.SafeRunnable.run(SafeRunnable.java:173) at org.eclipse.jface.viewers.StructuredViewer.updateItem(Structured Viewer.java:2159) at org.eclipse.jface.viewers.AbstractTableViewer.internalRefreshAll (AbstractTableViewer.java:674) at org.eclipse.jface.viewers.AbstractTableViewer.internalRefresh(Ab stractTableViewer.java:612) at org.eclipse.jface.viewers.AbstractTableViewer.internalRefresh(Ab stractTableViewer.java:604) at org.eclipse.jface.viewers.StructuredViewer.lambda$2(StructuredVi ewer.java:1508) at org.eclipse.jface.viewers.StructuredViewer$$Lambda$148/000000008 DE91430.run(Unknown Source) at org.eclipse.jface.viewers.StructuredViewer.preservingSelection(S tructuredViewer.java:1447) at org.eclipse.jface.viewers.StructuredViewer.preservingSelection(S tructuredViewer.java:1408) at org.eclipse.jface.viewers.StructuredViewer.refresh(StructuredVie wer.java:1508) at org.eclipse.jface.viewers.ColumnViewer.refresh(ColumnViewer.java :523) at org.eclipse.jface.viewers.StructuredViewer.refresh(StructuredVie wer.java:1467) at com.ibm.wmqfte.explorer.content.AgentContentPage$8.run(AgentCont entPage.java:822) at org.eclipse.swt.widgets.RunnableLock.run(RunnableLock.java:37) at org.eclipse.swt.widgets.Synchronizer.runAsyncMessages(Synchroniz er.java:182) at org.eclipse.swt.widgets.Display.runAsyncMessages(Display.java:45 77) at org.eclipse.swt.widgets.Display.readAndDispatch(Display.java:418 6) at org.eclipse.e4.ui.internal.workbench.swt.PartRenderingEngine$5.r un(PartRenderingEngine.java:1150) at org.eclipse.core.databinding.observable.Realm.runWithDefault(Rea lm.java:336) at org.eclipse.e4.ui.internal.workbench.swt.PartRenderingEngine.run (PartRenderingEngine.java:1039) at org.eclipse.e4.ui.internal.workbench.E4Workbench.createAndRunUI( E4Workbench.java:153) at org.eclipse.ui.internal.Workbench.lambda$3(Workbench.java:680) at org.eclipse.ui.internal.Workbench$$Lambda$14/000000008CE4EE60.ru n(Unknown Source) at org.eclipse.core.databinding.observable.Realm.runWithDefault(Rea lm.java:336) at org.eclipse.ui.internal.Workbench.createAndRunWorkbench(Workbenc h.java:594) at org.eclipse.ui.PlatformUI.createAndRunWorkbench(PlatformUI.java: 148) at com.ibm.mq.explorer.ui.rcp.internal.base.RcpApplication.start(Rc pApplication.java:152) at org.eclipse.equinox.internal.app.EclipseAppHandle.run(EclipseApp Handle.java:196) at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.run Application(EclipseAppLauncher.java:134) at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.sta rt(EclipseAppLauncher.java:104) at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStart er.java:388) at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStart er.java:243) at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessor Impl.java:90) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethod AccessorImpl.java:55) at java.lang.reflect.Method.invoke(Method.java:508) at org.eclipse.equinox.launcher.Main.invokeFramework(Main.java:653) at org.eclipse.equinox.launcher.Main.basicRun(Main.java:590) at org.eclipse.equinox.launcher.Main.run(Main.java:1499) at org.eclipse.equinox.launcher.Main.main(Main.java:1472)
Problem conclusion
The IBM MQ MFT component has been updated to tolerate the absence of the agent age in agent publication information on the Topics on the Coordination queue manager. --------------------------------------------------------------- The fix is targeted for delivery in the following PTFs: Version Maintenance Level v9.1 LTS 9.1.0.7 v9.2 LTS 9.2.0.1 v9.x CD 9.2.1 The latest available MQ maintenance can be obtained from 'WebSphere MQ Recommended Fixes' http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037 If the maintenance level is not yet available information on its planned availability can be found in 'WebSphere MQ Planned Maintenance Release Dates' http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309 ---------------------------------------------------------------
Temporary fix
Comments
APAR Information
APAR number
PH26607
Reported component name
IBM MQ MFT Z/OS
Reported component ID
5655MF900
Reported release
910
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2020-06-18
Closed date
2020-07-09
Last modified date
2020-08-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Fix information
Fixed component name
IBM MQ MFT Z/OS
Fixed component ID
5655MF900
Applicable component levels
[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"910","Line of Business":{"code":"LOB45","label":"Automation"}}]
Document Information
Modified date:
05 August 2020