IBM Support

IT07187: WMQ-FTE 7.0.4 OLD VERSIONS OF JSCH LIBRARIES LEFT ON FTE AGENT'SJAVA CLASSPATH

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • After applying WebSphere MQ File Transfer Edition maintenance
    that includes a newer version of the JSch library (which a
    protocol bridge agent uses to communicate with SFTP file
    servers), the older version of JSch library is still used in
    preference to the new version.
    

Local fix

  • Rename the old version of the JCch library so that the filename
    does include the string ".jar" or ".zip". For example:
    
      mv /lib/jsch-0.1.40.jar /lib/jsch-0.1.40.old
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users of WebSphere MQ File Transfer Edition
    who use a protocol bridge agent to communicate with SFTP file
    servers.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    When the third party JSch library, that is used by a WebSphere
    MQ File Transfer Edition (FTE) protocol bridge agent to
    communicate with an SFTP file server, is updated, older versions
    of the library should be excluded from the protocol bridge
    agent's Java classpath when the agent is started. For example,
    WebSphere MQ FTE v7.0.4 shipped the JSch library:
    
      jsch-0.1.40.jar
    
    APAR IC87351, which was included from WebSphere MQ FTE v7.0.4.3,
    updated the JSch library to:
    
      jsch-0.1.48.jar
    
    After applying the WebSphere MQ FTE v7.0.4.3 fix pack, the old
    jsch-0.1.40.jar library should not be included on an agent's
    classpath.
    
    In order to do this, WebSphere MQ FTE maintains an "exclude
    list" of old libraries that might still be present in the "lib"
    directory of the WebSphere MQ FTE installation but have since
    been superseded.
    
    However, a defect in the parsing of the exclude list at agent
    startup caused an incorrect interpretation of the entries
    concerning the JSch libraries. This resulted in older versions
    of the JSch still being included on an agent's classpath and
    used in preference to a later available version.
    
    The version of the JSch library supplied within the 0WebSphere
    MQ FTE v7.0.4.4 installation is "jsch-0.1.49.jar".
    

Problem conclusion

  • The WebSphere MQ File Transfer Edition (FTE) code has been
    updated such that the parsing of the exclude list for superseded
    JSch libraries correctly results in the older versions being
    omitted from a WebSphere MQ FTE Java classpath.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v7.0       7.0.4.5
    
    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

    IT07187

  • Reported component name

    WMQ FILE TRANSF

  • Reported component ID

    5724R1000

  • Reported release

    704

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2015-02-17

  • Closed date

    2015-02-26

  • Last modified date

    2015-02-26

  • 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:
26 February 2015