IT10333: FTE AGENT UNABLE TO LOAD ESE JAR AFTER INCORRECT SPLITTING OF FILES IN ADVANCEDMESSAGEPATH PROPERTY

WebSphere MQ File Transfer Edition V7.0 Fix Pack 7.0.4.6

APAR status

• Closed as program error.

Error description

• When multiple .jar files are specified in the
  "advancedSecurityPath" agent property, separated using a
  semi-colon character, ";", a defect in the property parsing
  resulted in the character before the semicolon being stripped
  when the jar file list is split. For example, setting the
  following in the agent.properties file:
  
  advancedSecurityPath=
  /opt/ibm/WebSphere/MQAMS/classes/com.ibm.mq.ese.jar;/opt/mqm/jav
  a/lib/com.ibm.mq.jar
  
  resulted in the agent trying to load the jar file:
  
  /opt/ibm/WebSphere/MQAMS/classes/com.ibm.mq.ese.ja
  
  which fails with following error logged to the agent's
  output0.log file:
  
  BFGAG0126E: One or more files specified in the
  extendedSecurityPath property were not found. The WebSphere MQ
  Advanced Message Security interceptor might not be loaded, or it
  might be partially loaded and malfunction. The agent will stop.
  The missing file(s) are:
  /opt/ibm/WebSphere/MQAMS/classes/com.ibm.mq.ese.ja
  

Local fix

• Add an extra space between the last character of the jar file
  and and the
  semi-colon. For example:
  
  advancedSecurityPath=
  /opt/ibm/WebSphere/MQAMS/classes/com.ibm.mq.ese.jar ;/opt/mqm/ja
  va/ lib/com.ibm.mq.jar
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  This issue affects all users of WebSphere MQ File Transfer
  Edition who use the agent property:
  
    advancedSecurityPath
  
  to load multiple jar files for use with WebSphere MQ Advanced
  Message Security.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  When using WebSphere MQ File Transfer Edition (FTE) with
  WebSphere MQ Advanced Message Security (AMS), the agent
  property:
  
    advancedSecurityPath
  
  can be used to specify the location of one or more Java archive
  (jar) files, separated by non-escaped semicolon characters. This
  property is specified in the "agent.properties" file. To use
  WebSphere MQ AMS with WebSphere MQ FTE, use the
  "advancedSecurityPath" agent property to specify the location of
  the WebSphere MQ AMS Java Interceptor jar file:
  
    com.ibm.mq.ese.jar
  
  and the pre-requisite WebSphere MQ Java client jar file:
  
    com.ibm.mq.jar
  
  For example:
  ---------------
  advancedSecurityPath=
  /opt/ibm/WebSphere/MQAMS/classes/com.ibm.mq.ese.jar;
  /opt/mqm/java/ lib/com.ibm.mq.jar
  
  
  When multiple jar files are specified, using with the
  "advancedSecurityPath" agent property, the agent splits the
  property value on non-escaped semicolon characters and attempts
  to load to each jar file.
  
  However a defect in the regular expression splitting code
  resulted in the character directly preceding the semicolon from
  being removed from the returned path. Continuing the example
  above, this would result in the agent attempting to load the jar
  files "/opt/ibm/WebSphere/MQAMS/classes/com.ibm.mq.ese.ja" and
  "/opt/mqm/java/ lib/com.ibm.mq.jar". The agent therefore
  attempted to load
  "/opt/ibm/WebSphere/MQAMS/classes/com.ibm.mq.ese.ja" fails with
  a BFGAG0126E logged to the agent's ouptut0.log file.
  

Problem conclusion

• The WebSphere MQ File Transfer Edition product code has been
  updated to correct the splitting of jar files, separated by
  non-escaped semicolon characters, specified as the value to the
  agent property:
  
    advancedSecurityPath
  
  As such, the character directly before the semicolon character,
  on which the split is performed, is not removed from the
  returned jar file path.
  
  In addition, the reference to the property
  "extendedSecurityPath" in the error and warning messages:
  
    - BFGAG0126E
    - BFGAG0127E
    - BFGAG0128W
  
  has been corrected to be "advancedSecurityPath".
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v7.0       7.0.4.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 FILE TRANSF

• Fixed component ID

  5724R1000

Applicable component levels

• R704 PSY

     UP