IBM Support

IT29811: IBM MQ MFT: Transferring files to a destination Protocol Bridge Agent fails with error BFGBR0119E.

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

APAR status

  • Closed as program error.

Error description

  • Managed file transfers to a destination protocol bridge agent
    fail after the first file that gets transferred into the target
    directory.
    The subsequent attempts to transfer files into the same
    destination directory fail with the following error message:
    	BFGTR0072E: The transfer failed to complete due to the
    exception : BFGBR0119E: Bridge agent was unable to create
                                 directory Home because Cannot
    create directory: /Home/Mars_MX_RE_UAT/Home exists
    
    Trace shows that the protocol bridge agent is attempting to
    create the same directory structure nested in the already
    existing directory structure.
    For example:
    	First pass creates:
    		/Home/UAT/In/
    	Second managed file transfer tries to create:
    		/Home/UAT/In/Home/UAT/In
    

Local fix

  • Check if the sftp user, setup in ProtocolBridgeCredentials has
    permission to access /Home directory.  If it does not, grant
    the proper file permissions to the sftp user.
    on the sftp server
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users of IBM MQ Managed File Transfer who
    have protocol bridge agents that transfer files to file servers
    using the SFTP protocol.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    When using a protocol bridge agent (PBA) as a destination agent
    to transfer files to a file server using the SFTP protocol, two
    issues would occur if the file server did not provide read and
    execute permissions to a users home directory:
    
    - The first managed transfer into a subdirectory beneath the
    user's home directory would be reported as "successful", even
    though the location of the destination file was incorrect as the
    PBA had incorrectly recreated the user's home directory path
    within the home directory (for example, an attempt to transfer a
    file into /Home/Username/Output would result in the file being
    created in the directory /Home/Username/Home/Username/Output).
    
    - Subsequent managed transfers that tried to transfer a file
    into the same subdirectory would fail with an error similar to
    the one shown below:
    "BFGTR0072E: The transfer failed to complete due to the
    exception : BFGBR0119E: Bridge agent was unable to create
    directory Home because Cannot create directory:
    /Home/UserName/Home exists"
    as the PBA would be unable to create the user's home directory
    path within the home directory:
    

Problem conclusion

  • IBM MQ Managed File Transfer  has been updated so that when a
    protocol bridge agent is connecting to a file server using the
    SFTP protocol and is acting as the destination agent for a
    managed transfer, where the destination filename contains a
    relative path, then the agent will create the destination file
    path relative to the user's home directory on the SFTP server.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v9.0 LTS   9.0.0.9
    v9.1 CD    9.1.4
    v9.1 LTS   9.1.0.4
    
    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

    IT29811

  • Reported component name

    IBM MQ MFT V9.1

  • Reported component ID

    5724H7272

  • Reported release

    910

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2019-07-23

  • Closed date

    2019-09-30

  • Last modified date

    2019-09-30

  • 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

    IBM MQ MFT V9.1

  • Fixed component ID

    5724H7272

Applicable component levels

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

Document Information

Modified date:
30 September 2019