IBM Support

IT15522: FTECLEANAGENT RUN WITH NO PARAMETERS DOES THE EQUIVALENT OF -ALL POTENTIALLY CLEARING OUT SCHEDULED TRANSFERS

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

  • When running the fteCleanAgent command with only the agent name
    and no arguments specified the behaviour is equivalent to
    fteCleanAgent <agentName> -all. As a result, all in-progress and
    pending transfers, resource monitor definitions and scheduled
    transfers definitions on the agent the command was run against
    are cleared.
    
    As an example, the following two commands result in the same
    behaviour:
    
    fteCleanAgent  agent100
    fteCleanAgent  -all agent100
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects the users of the fteCleanAgent command on the
    following product releases:
    
    - IBM MQ  v9
    - IBM MQ  v8
    - WebSphere MQ v7.5 Managed File Transfer
    - WebSphere MQ File Transfer Edition v7.0.4
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    When the fteCleanAgent command was run with only the agent name
    specified, it would run as if the user supplied the -all
    argument.  This cleared all in-progress and pending transfers,
    resource monitor definitions and scheduled transfer definitions
    on the agent.  Therefore the following two commands would result
    in the same behaviour:
    
    fteCleanAgent  agent100
    fteCleanAgent  -all agent100
    

Problem conclusion

  • The fteCleanAgent command has been updated such that a user must
    specify which Managed File Transfer state to clear by passing
    the appropriate parameters to the command, as well as providing
    an agent name.
    
    This change in behaviour ensures that by default fteCleanAgent
    does not clear all in-progress and pending transfers,  resource
    monitor definitions and scheduled transfer definitions for the
    agent specified.
    
    The list of allowed parameters has not been changed by this APAR
    and is documented in the IBM MQ Knowledge Center:
    
    https://www.ibm.com/support/knowledgecenter/SSFKSJ_9.0.0/com.ibm
    .wmqfte.doc/clean_agent_cmd.htm
    
    This APAR also adds a new property to revert fteCleanAgent to
    its original behaviour if required.  The property is set in the
    command.properties file and is called
    "failCleanAgentWithNoArguments".
    
    By default the value of "failCleanAgentWithNoArguments" is true,
    and the fteCleanAgent command will fail to run if only the agent
    name parameter is specified.
    
    Setting the property "failCleanAgentWithNoArguments" to false
    reverts to the original behaviour for fteCleanAgent, where if
    only the agent name parameter is set, the behaviour of the
    command is equivalent to specifying  the -all flag.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v7.5       7.5.0.8
    v8.0       8.0.0.7
    v9.0 CD    9.0.3
    v9.0 LTS   9.0.0.2
    
    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

    IT15522

  • Reported component name

    WMQ FILE TRANSF

  • Reported component ID

    5724R1000

  • Reported release

    704

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-05-31

  • Closed date

    2017-03-27

  • Last modified date

    2017-05-10

  • 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:
10 May 2017