IT08384: WMQ 7.5 MANAGED FILE TRANSFER - FTP CONNECTION RECEIVES A 426 (CONNECTION CLOSED: TRANSFER ABORTED) BUT MFT REPORTS BFGRP0032I

APAR status

• Closed as program error.

Error description

• An attempt to FTP a file using WMQ 7.5 Managed File Transfer
  results in the following message:
  .
    BFGRP0032I: The file transfer request has successfully
                completed
  .
  When checking the FTP server there was a zero byte file.
  .
  A network trace shows that FTP data connection received
  426 error: Connection closed; transfer aborted.
  .
  The Protocol Bridge Agent did not handle this FTP reply
  code correctly. It assumes that the file transfer has
  completed successfully when it should have determined
  the transfer failed based on the 426 return code.
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  This issue affects users of:
  
  - The WebSphere MQ V7.5 Managed File Transfer component.
  - The WebSphere MQ V8.0 Managed File Transfer component.
  
  who are using the Protocol Bridge Agent to connect to a file
  server using either the FTP or FTPS protocol.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  When a WebSphere MQ Managed File Transfer Protocol Bridge Agent
  is acting as a Destination Agent in a managed transfer, and is
  connecting to a file server using either the FTP or FTPS
  protocol, it will establish two connections to the file server:
  
  - A control connection. This is used by the Protocol Bridge
  Agent and the file server to initiate file transfers, and
  monitor their state.
  - A data connection, which is used to send the file data to the
  file server.
  
  If a file transfer is in progress, and the data connection is
  closed, the file server will send FTP reply code 426 to the
  Protocol Bridge Agent.
  
  In most cases, the Protocol Bridge Agent would put a managed
  transfer into recovery if it received this FTP reply code from a
  file server. However, if the Protocol Bridge Agent received this
  reply code after it had sent the last piece of file data to the
  file server, it incorrectly assumed that the reply code had
  already been handled, and so ignored it. As a result of this,
  the transfer item that was being transferred when the data
  connection was closed was marked as as being "Successful", even
  though the file was not successfully written by the file server.
  

Problem conclusion

• The Protocol Bridge Agent has been updated so that if a file
  server returns FTP reply code 426 while writing the last piece
  of file data, the Protocol Bridge Agent will put the transfer
  into recovery. If the property:
  
    logTransferRecovery=true
  
  has been set on the Protocol Bridge Agent, then the message
  similar to the one shown below will be written to the Agent's
  output0.log file:
  
  BFGTR0030E: A recoverable I/O error has occurred during a write
  operation. The agent will attempt to recover the file transfer.
  The transfer ID is: . The error message is: BFGBR0186W: The
  server has terminated the connection. The reply string sent back
  by the server was 'PB-CLOSE - aborted [ReplyString=426
  Connection closed; transfer aborted]
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v7.5       7.5.0.6
  v8.0       8.0.0.3
  
  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 is sysrouted FROM one or more of the following:

  IT07634

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  WMQ MFT

• Fixed component ID

  5724H7242

Applicable component levels

• R750 PSY

     UP