A fix is available
APAR status
Closed as program error.
Error description
The fteCleanAgent command fails for Connect:Direct Bridge Agents when the -p parameter is used to specify a non-default set of configuration options. The error message BFGAP0014E is returned to the user. For example: $ ./fteCleanAgent -p CONFIG_OPTIONS_B CD_BRIDGE_AGENT 5724-H72 Copyright IBM Corp. 2008, 2012. ALL RIGHTS RESERVED BFGAP0014E: The configuration options directory '/var/mqm/mqft/config/CONFIG_OPTIONS_A' does not exist, or does not contain a required properties file. where: - CONFIG_OPTIONS_B is the user specified name for the non-default configuration options to use. - CD_BRIDGE_AGENT is the name of the Connect:Direct Bridge Agent that the fteCleanAgent command is to operate on. - CONFIG_OPTIONS_A is the name of the default configuration options.
Local fix
Problem summary
**************************************************************** USERS AFFECTED: This issue affects users of WebSphere MQ Managed File Transfer who are running the fteCleanAgent command with the -p parameter to clean the queues used by a Connect:Direct bridge agent that is not located under the default configuration. Platforms affected: MultiPlatform **************************************************************** PROBLEM SUMMARY: Although the -p parameter was specified when running the fteCleanAgent command, the default configuration options, as specified in the WebSphere MQ Managed File Transfer wmqfte.properties file, were being used instead. This can result in the following: 1) the fteCleanAgent command was run against an incorrect temporary directory 2) the fteCleanAgent command reported an error message such as: BFGAP0014E: The configuration options directory '/var/mqm/mqft/config/CONFIG_OPTIONS_A' does not exist, or does not contain a required properties file. or BFGAP0018E: An internal error has occurred. Unable to complete the command because the agent directory '/var/mqm/mqft/config/CONFIG_OPTIONS_A/agents/CD_BRIDGE_AGENT' does not exist. where "CONFIG_OPTIONS_A" is the name of the default configuration options and "CD_BRIDGE_AGENT" was the name of the Connect:Direct bridge agent to run the fteCleanAgent command against. The problem occurred when the fteCleanAgent command attempted to query the location of the Connect:Direct temporary directory. This is the directory used by a Connect:Direct bridge agent to temporarily store files before they are transferred onto the destination Connect:Direct node. The user-specified name for the non-default set of configuration options to use was not being passed correctly to the mechanism responsible for querying the Connect:Direct temporary directory. As such, the fteCleanAgent command attempted to use the default set of configuration options. This behaviour was incorrect.
Problem conclusion
The WebSphere MQ Managed File Transfer Connect:Direct bridge agent has been updated so that the name of the non-default configuration options, specified using the -p parameter on the fteCleanAgent command, is used to query the temporary directory for a Connect:Direct bridge agent. --------------------------------------------------------------- The fix is targeted for delivery in the following PTFs: Version Maintenance Level v7.5 7.5.0.3 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
IC98545
Reported component name
WMQ FTE
Reported component ID
5724H7242
Reported release
750
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2014-01-02
Closed date
2014-01-06
Last modified date
2014-05-01
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 FTE
Fixed component ID
5724H7242
Applicable component levels
R750 PSY
UP
[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSDEZSF","label":"IBM WebSphere MQ Managed File Transfer for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]
Document Information
Modified date:
27 January 2022