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":"LOB45","label":"Automation"}}]
Document Information
Modified date:
30 September 2019