IBM Support

IT36233: MQ MFT: Agent property monitorGroupRetryLimit=-1 not behaving asexpected

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

  • Using IBM MQ MFT, the agent's resource monitor stopped retrying
    the group of messages on the monitored queue.  Even though the
    agent property monitorGroupRetryLimit=-1 is set in the
    agent.properties file, the agent records a BFGDM0100E error in
    the
    output0.log file.  For example:
    
    BFGDM0100E: The number of times that the monitor task has been
    re-tried for groupId:
    '414d51204d46545433202020202020209a8b23602bd93b23' on queue:
    'MY.QL' has exceeded the value specified by the agent property
    monitorGroupRetryLimit.
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    IBM MQ MFT users using MFT resource monitor
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    If a message-to-file transfer that is triggered by a resource
    monitor fails and leaves the message group that triggered the
    monitor on the queue,
    that transfer is resubmitted at subsequent poll intervals.
    
    The number of times that the transfer is resubmitted is limited
    by the monitorGroupRetryLimit property of the monitoring agent.
    By setting it to -1 the transfer task is expected to be
    continuously retried, but this does not happen and the agent
    displayed the BFGDM0100E error message on the output.log
    An example of error message is shown below:
    
    BFGDM0100E: The number of times that the monitor task has been
     re-tried for groupId:
    '414d51204d46545433202020202020209b8b23602bd93b23' on queue:
    'MY.QU' has exceeded the value specified by the agent property
    monitorGroupRetryLimit.
    

Problem conclusion

  • IBM MQ MFT resource monitor has been updated such that setting
    monitorGroupRetryLimit to -1 will continuously retry the monitor
    transfer task.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v9.1 LTS   9.1.0.10
    v9.2 LTS   9.2.0.4
    v9.x CD    9.2.5
    
    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

    IT36233

  • 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

    2021-03-15

  • Closed date

    2021-10-06

  • Last modified date

    2021-10-07

  • 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

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

Document Information

Modified date:
13 October 2021