IBM Support

IT10866: FTE FAILS TO START A QUEUE-TO-FILE TRANSFER AND REPORTS ERROR "BFGCH0005E" IN THE AGENT OUTPUT0.LOG LOG FILE

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • With MQ File Transfer Edition queue-to-file transfers may fail
    if two or more messages are put to the queue with the same
    message Id. In the Agent log file output0.log the following
    error is reported:
    "BFGCH0027I: An internal error has occurred. The command message
    has been discarded because 'BFGCH0005E: A problem occurred when
    registering a file transfer request.'"
    ...and an FFDC is written with the following details :
    Class: com.ibm.wmqfte.cmdhandler.impl.MessageHandlerImpl
    Method: externalMessageHandler
    Probe: FFDC_001
    Cause:
    com.ibm.wmqfte.cmdhandler.FTECommandHandlerErrorException:
    BFGCH0005E: A problem occurred when registering a file transfer
    request.
    com.ibm.wmqfte.cmdhandler.FTECommandHandlerErrorException:
    BFGCH0005E: A problem occurred when registering a file transfer
    request.
    at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerStateStoreImpl.p
    rocessFileTransfer(FTECommandHandlerStateStoreImpl.java:393)
    at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandIntepreterFileTransfer.
    interpret(FTECommandIntepreterFileTransfer.java:266)
    at
    com.ibm.wmqfte.cmdhandler.impl.MessageHandlerImpl.externalMessag
    eHandler(MessageHandlerImpl.java:204)
    at
    com.ibm.wmqfte.cmdhandler.impl.MessageHandlerImpl.processCommand
    (MessageHandlerImpl.java:142)
    at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerWorkerThread.pro
    cessCommand(FTECommandHandlerWorkerThread.java:239)
    at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerWorkerThread.run
    (FTECommandHandlerWorkerThread.java:143)
    at java.lang.Thread.run(Thread.java:736)
    at com.ibm.wmqfte.thread.FTEThread.run(FTEThread.java:52)
    Caused by: com.ibm.wmqfte.statestore.FTEStateStoreException:
    BFGSS0020E: An internal error has occurred. Transfer ID
    414d512050314d53424b30312020202055ae6b1d204a6302.
    at
    com.ibm.wmqfte.statestore.impl.FTEStateStorePersistence.putSende
    r(FTEStateStorePersistence.java:1055)
    at
    com.ibm.wmqfte.statestore.impl.FTEStateStoreImpl.newSenderTransf
    er(FTEStateStoreImpl.java:733)
    at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerStateStoreImpl.p
    rocessFileTransfer(FTECommandHandlerStateStoreImpl.java:368)
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users of WebSphere MQ File Transfer Edition
    V7.0.4 who generate their own transfer ids or use a queue
    monitor to generate message-to-file transfers.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    The transfer ids of File Transfer Edition transfers must be
    unique. The transfer id of a transfer is the message id of the
    transfer request message on the SYSTEM.FTE.COMMAND. queue. When
    using the fteCreateTransfer command to generate a transfer the
    message id of the transfer request message is auto-generated by
    WebSphere MQ and will be unique. However it is possible for a
    user to put transfer requests onto the SYSTEM.FTE.COMMAND. queue
    specifying their own message id. In this case it is the users
    responsibility to ensure that the message ids are unique. When
    using a queue monitor to transfer messages from a queue to a
    file the message id is taken from the message id of the message
    on the input queue. It is the users responsibility to ensure
    that the message ids of the messages on the input queue are
    unique.
    
    If a duplicate transfer id is detected by the WebSphere File
    Transfer Edition Agent the following error is reported in the
    output0.log file
    
    "BFGCH0027I: An internal error has occurred. The command message
    has been discarded because 'BFGCH0005E: A problem occurred when
    registering a file transfer request.'"
    
    An FFDC is also generated containing the following :
    
    Class: com.ibm.wmqfte.cmdhandler.impl.MessageHandlerImpl
    Method: externalMessageHandler
    Probe: FFDC_001
    Cause:
    com.ibm.wmqfte.cmdhandler.FTECommandHandlerErrorException:
    BFGCH0005E: A problem occurred when registering a file transfer
    request.
    com.ibm.wmqfte.cmdhandler.FTECommandHandlerErrorException:
    BFGCH0005E: A problem occurred when registering a file transfer
    request.
    at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerStateStoreImpl.p
    rocessFileTransfer(FTECommandHandlerStateStoreImpl.java:393)
    at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandIntepreterFileTransfer.
    interpret(FTECommandIntepreterFileTransfer.java:266)
    at
    com.ibm.wmqfte.cmdhandler.impl.MessageHandlerImpl.externalMessag
    eHandler(MessageHandlerImpl.java:204)
    at
    com.ibm.wmqfte.cmdhandler.impl.MessageHandlerImpl.processCommand
    (MessageHandlerImpl.java:142)
    at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerWorkerThread.pro
    cessCommand(FTECommandHandlerWorkerThread.java:239)
    at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerWorkerThread.run
     (FTECommandHandlerWorkerThread.java:143)
    at java.lang.Thread.run(Thread.java:736)
    at com.ibm.wmqfte.thread.FTEThread.run(FTEThread.java:52)
    Caused by: com.ibm.wmqfte.statestore.FTEStateStoreException:
    BFGSS0020E: An internal error has occurred. Transfer ID
    414d512050314d53424b30312020202055ae6b1d204a6302.
    at
    com.ibm.wmqfte.statestore.impl.FTEStateStorePersistence.putSende
    r(FTEStateStorePersistence.java:1055)
    at
    com.ibm.wmqfte.statestore.impl.FTEStateStoreImpl.newSenderTransf
    er(FTEStateStoreImpl.java:733)
    at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerStateStoreImpl.p
    rocessFileTransfer(FTECommandHandlerStateStoreImpl.java:368)
    
    The "Caused by:" error is reported as "BFGSS0020E: An internal
    error has occurred. Transfer ID " which gives little hint on the
    cause of the problem and how it can be resolved.
    

Problem conclusion

  • The error message text for the "BFGSS0020E" error has been
    updated to:
    "BFGSS0020E: A sending transfer with the transfer ID , is
    already present within the agent."
    This gives a clear indication of the cause of the problem.
    
    The "explanation" text has been updated to:
    "The transfer ID of a transfer, which is the message ID of the
    transfer request message that initiated the transfer, must be
    unique. ".
    
    The "user action" text has been updated to :
    "If you are using a queue monitor to submit message to file
    transfer requests, ensure that the message IDs of the messages
    on the input queue are unique. If you are putting transfer
    request messages to the agent command queue either let the queue
    manager default the message ID, or ensure that the message IDs
    specified are unique. If you cannot resolve the problem, contact
    the IBM support center for further assistance."
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v7.0       7.0.4.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

    IT10866

  • 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-08-24

  • Closed date

    2015-10-20

  • Last modified date

    2015-10-23

  • 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:
23 October 2015