IBM Support

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

Subscribe

You can track all active APARs for this component.

 

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 number

    IT10333

  • Reported component name

    WMQ FILE TRANSF

  • Reported component ID

    5724R1000

  • Reported release

    704

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2015-07-24

  • Closed date

    2015-08-21

  • Last modified date

    2016-05-05

  • 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

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSEP7X","label":"WebSphere MQ File Transfer Edition"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0.4","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
05 May 2016