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":"LOB45","label":"Automation"}}]
Document Information
Modified date:
10 May 2017