IT09457: WMQ-MFT 7.5.0.5 BRIDGE AGENT ABENDS TRANSFERRING TO OR FROM FTP SERVERS

7.5.0.5-WS-MQFTE-JavaVM-LAIT09457

APAR status

• Closed as program error.

Error description

• A WebSphere MQ v7.5.0.5 Managed File Transfer (MFT) protocol
  bridge agent ABENDs when transferring to or from an FTP or FTPS
  file server. The ABEND log file contains the following:
  Filename:
  
  C:\ProgramData\IBM\MQ\mqft\logs\MFT75_QMGR\agents\BRIDGE\logs\ff
  dc\ABEND.FTE.20150615124516327.97738147077367632.log
  Level: f750-FP-20150212-0903
  Time: 15/06/2015 12:45:16:327 BST
  Thread: 31 (CommandHandlerWorker-0)
  Class: com.ibm.wmqfte.thread.FTEThread
  Instance: 31ad31ad
  Method: uncaughtException
  Probe: ABEND_001
  Cause: java.lang.NoClassDefFoundError:
   org.apache.commons.net.ftp.FTPClientConfig
  java.lang.NoClassDefFoundError:
   org.apache.commons.net.ftp.FTPClientConfig
   at
  com.ibm.wmqfte.bridge.session.ftp.SessionFactory.serverConfigura
  tion(SessionFactory.java:201)
   at com.ibm.wmqfte.bridge.Bridge.(Bridge.java:166) at
  com.ibm.wmqfte.bridge.BridgeManager.createBridge(BridgeManager.j
  ava:324)
   at
  com.ibm.wmqfte.io.bridge.BridgeFileFactoryHelperImpl.openTransfe
  r(BridgeFileFactoryHelperImpl.java:291)
   at
  com.ibm.wmqfte.io.FTEFileFactory.openTransfer(FTEFileFactory.jav
  a:899)
  
  If a WebSphere MQ MFT protocol bridge agent is configured with a
  default server in its ProtocolBridgeProperties.xml file that is
  an FTP or FTPS server, the agent will not start. The Java
  exception logged to the agent's output0.log file is:
  
  BFGBS0005E: An internal error has occurred. The exception
  details follow this message.
  java.lang.reflect.InvocationTargetException
   at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
   at
  sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessor
  Impl.java:60)
   at
  sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethod
  AccessorImpl.java:37)
   at java.lang.reflect.Method.invoke(Method.java:611)
   at
  com.ibm.wmqfte.agent.bootstrap.impl.BootstrapMain.run(BootstrapM
  ain.java:290)
   at
  com.ibm.wmqfte.agent.bootstrap.impl.BootstrapMain.main(Bootstrap
  Main.java:131)
  Caused by: java.lang.NoClassDefFoundError:
   org.apache.commons.net.ftp.FTPClientConfig
   at
  com.ibm.wmqfte.bridge.session.ftp.SessionFactory.serverConfigura
  tion(SessionFactory.java:201)
   at com.ibm.wmqfte.bridge.Bridge.(Bridge.java:166) at
  com.ibm.wmqfte.bridge.BridgeManager.intialiseBridge(BridgeManage
  r.java:118)
   at com.ibm.wmqfte.agent.Agent.doInitialisation(Agent.java:684)
   at
  com.ibm.wmqfte.agent.AgentRuntime.mainLoop(AgentRuntime.java:457
  ) at
  com.ibm.wmqfte.agent.Agent.main(Agent.java:293)
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  This issue affects all users of WebSphere MQ v7.5.0.5 Managed
  File Transfer (MFT) who use a protocol bridge agent to transfer
  files to or from file servers using the FTP or FTPS protocols.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  APAR IT00286:
  
  http://www-01.ibm.com/support/docview.wss?uid=swg1IT00286
  
  should have updated the level of the Apache Commons Net library,
  used by a WebSphere MQ Managed File Transfer protocol bridge
  agent, to v2.2 (filename: commons-net-2.2.jar). The changes made
  under this APAR therefore excluded the older version of this
  library, v2.0 (filename: commons-net-2.0.jar), from the agent's
  Java class path. However the installer for the WebSphere MQ
  v7.5.0.5 Managed File Transfer component did not install the
  newer version of the library.
  
  Therefore, when a protocol bridge agent attempt to perform a
  transfer either to or from an FTP or FTPS file server, the code
  provided by this library was unavailable and
  java.lang.NoClassDefFoundError was thrown.
  

Problem conclusion

• This APAR corrects the installer for the WebSphere MQ Managed
  File Transfer component such that, for future fix packs, the
  later version of the Apache Commons Net library (v2.2) is
  installed to the "mqft/lib" directory as expected.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v7.5       7.5.0.6
  
  The latest available FTE maintenance can be obtained from
  'Fix List for WebSphere MQ File Transfer Edition 7.0'
  http://www-01.ibm.com/support/docview.wss?uid=swg27015313
  
  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 is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  WMQ MFT

• Fixed component ID

  5724H7242

Applicable component levels

• R750 PSY

     UP