IT09186: MQ MFT 8.0 AND IIB 9.0.0.3: FTE EMBEDDED AGENT FAILS TO START WHEN RUNNING WITHIN AN IIB EXECUTION GROUP

WebSphere MQ File Transfer Edition V7.0 Fix Pack 7.0.4.6

APAR status

• Closed as program error.

Error description

• The MQ Java client 8.0 is preventing the FTE embedded agent to
  start when running within an IIB execution group.
  .
  com.ibm.wmqfte.api.EmbeddedAgentInternalException: BFGEA0016E:
  An
  internal error has occurred. The exception was: 'null'
  at com.ibm.wmqfte.api.EmbeddedAgentWrapper.runAgent
  (EmbeddedAgentWr apper.java:107)
  at com.ibm.broker.fte.FTEAgent$RunFTEAgent.run
  (FTEAgent.java:579)
  at java.lang.Thread.run(Thread.java:795)
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  This issue affects all users of the WebSphere MQ v7.0.4.4 File
  Transfer Edition (FTE) embedded agent that uses the IBM MQ v8
  Java client.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  The WebSphere MQ v7.0.4.4 File Transfer Edition (FTE) embedded
  agent, upon startup, attempted to ascertain the exact product
  versions of the IBM MQ Java client code in use for communication
  with an IBM MQ queue manager. This information should have then
  been logged to the embedded agent's log file. However, an issue
  existed in the IBM MQ classes for Java such that the embedded
  agent was unable to query this information correctly. This
  resulted in the embedded agent failing to start, which in turned
  caused IBM Integration Bus v9.0.0.3 to throw the following
  exception:
  
  'java.lang.NullPointerException'; thrown from class name:
  'com.ibm.broker.nodes.filenodes.ManagedFileInputNode', method
  name:
  'getNextLocalFile', file: 'ManagedFileInputNode.java', line:
  '122'
  

Problem conclusion

• The IBM MQ classes for Java have been updated such that the
  WebSphere MQ v7.0.4.4 File Transfer Edition embedded agent can
  successfully query the level of IBM MQ Java client code that is
  available in the IBM Integration Bus execution group environment
  in which it is running.
  
  A code change has also been made to the WebSphere MQ File
  Transfer Edition Embedded Agent such that, if the IBM MQ Java
  client code cannot be queried from the environment, the Embedded
  Agent can still start.  In this scenario, the WebSphere MQ File
  Transfer Edition Embedded Agent will report blank version
  information for the IBM MQ Java client.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v7.0       7.0.4.6
  v8.0       8.0.0.3
  
  The latest available 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 BASE MULTIP

• Fixed component ID

  5724H7251

Applicable component levels

• R800 PSY

     UP