IBM Support

IT39219: fteShowAgentDetails can output incorrect/inconsistent information

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

  • The command:
    /opt/mqm/bin/fteShowAgentDetails -d  MFAGENT1
    
    Agent status information states that: the agent is ready to
    process transfers, but none are in progress This is obviously
    untrue as further down the page the command lists the two
    transfers that are currently in progress.  I can understand why
    the conflict but unless the status can be corrected (doubtful)
    then the text needs to be amended to say something like no
    transfers were in progress when this status was published.
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users using IBM MQ 9.2 Managed File Transfer
    fteShowAgentDetails command.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    When using the fteShowAgentDetails command with the -d option.
     The output of the Agent Status Details may indicate that:
    
    "The agent is running and is publishing its status at regular
    intervals. The last update was received within the expected time
    period. The agent is ready to process transfers, but none are
    currently in progress."
    
    This may not be true, as the output of the command can show a
    number of transfers that are currently in progress.
    In such situation, displaying agent status as 'running' and not
    'active' is not correct.
    

Problem conclusion

  • fteShowAgentDetails command has been updated such that when
    diagnostic information (-d) is requested
    and there are active source or destination transfers running in
    the agent,
    the agent status will be updated to active state, even if the
    agent has not received its current agent status message yet.
    
    As there is a possibility of receiving the current agent status
    message after receiving the transfer status messages.
    The ready agent status description has been updated to reflect
    this:
    "The agent is running and is publishing its status at regular
    intervals. The last update was received within the expected time
    period. The agent is ready to process transfers. No transfers
    were in progress when the status was last published."
    
    ---------------------------------------------------------------
    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.5
    v9.x CD    9.2.5
    
    The latest available 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

    IT39219

  • Reported component name

    IBM MQ BASE MP

  • Reported component ID

    5724H7271

  • Reported release

    910

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2021-11-26

  • Closed date

    2021-11-30

  • Last modified date

    2021-11-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 BASE MP

  • Fixed component ID

    5724H7271

Applicable component levels

[{"Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"910"}]

Document Information

Modified date:
02 December 2021