IBM Support

IT15003: The MFT configurationDirectory and productDirectory values passed to user exits are incorrect

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • After an upgrade from IBM MQ MFT 7.5 to 8.0 the following
    is seen when calling an exit.
    
    For MQ MFT 7.5
    com.ibm.wmqfte.AgentVersion=7.5.0.4
    com.ibm.wmqfte.ConfigurationDirectory=
      /var/mqm/mqft/config/MY_MFT/agents/AGENT1
    com.ibm.wmqfte.ProductDirectory=/opt/mqm/mqft
    
    After Upgrade: MQ MFT 8.0:
    com.ibm.wmqfte.AgentVersion=8.0.0.4,
    com.ibm.wmqfte.ConfigurationDirectory=/opt/mqm/mqft
    com.ibm.wmqfte.ProductDirectory=
      /var/mqm/mqft/config/MY_MFT/agents/AGENT1
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects all users of IBM MQ v8 Managed File Transfer
    who have written transfer exits that query the metadata values
    associated with the keys:
    
      - AGENT_CONFIGURATION_DIRECTORY_KEY
      - AGENT_PRODUCT_DIRECTORY_KEY
    
    from the environment metadata Map passed as argument when the
    exit is invoked.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    When using IBM MQ v8 Managed File Transfer, incorrect
    information was passed to transfer exits within the
    environmentMetaData Map object.  The environmentMetaData Map
    contains key/value pair information about the environment in
    which the implementation of the transfer exit is running.  As
    documented in the product Knowledge Center:
    
    http://www.ibm.com/support/knowledgecenter/SSFKSJ_8.0.0/com.ibm.
    wmqfte.doc/metadata.htm?lang=en
    
    The value corresponding to the key:
    
      AGENT_CONFIGURATION_DIRECTORY_KEY
    
    should have been the name of the directory that contains the
    agent's configuration information.  However, the value returned
    was actually the name of the directory that the agent code has
    been installed into.  This information should have instead been
    accessible via the key:
    
      AGENT_PRODUCT_DIRECTORY_KEY
    
    The name of the directory that contains the agent's
    configuration information was erroneously stored with the
    AGENT_PRODUCT_DIRECTORY_KEY.
    

Problem conclusion

  • The IBM MQ v8 Managed File Transfer product code has been
    updated such that transfer exists are passed environment
    metadata Map objects with the correct values for the keys:
    
      AGENT_CONFIGURATION_DIRECTORY_KEY :
      (The name of the directory that contains the agent's
    configuration information.)
    
      AGENT_PRODUCT_DIRECTORY_KEY :
      (The name of the directory that the agent code has been
    installed in.)
    
    as per the Knowledge Center documentation.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v8.0       8.0.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 number

    IT15003

  • Reported component name

    WMQ MFT V8.0

  • Reported component ID

    5724H7252

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-04-28

  • Closed date

    2016-05-18

  • Last modified date

    2017-06-01

  • 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 V8.0

  • Fixed component ID

    5724H7252

Applicable component levels

  • R800 PSY

       UP

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

Document Information

Modified date:
01 June 2017