APAR status
Closed as program error.
Error description
The BFGCUSTM member contained within the SBFGCMDS PDSE provided by IBM MQ Managed File Transfer for z/OS is run to create some customized members for a database logger. After running the BFGLGCR member to create the database logger, the database logger is started using the BFGLGSTP procedure. When the database logger starts up, it writes the warning message: BFGUB0078W: The property name "CLEAN_AGENT_PROPS" in file "logger.properties" of "<logger name>" is not a valid MQMFT property and will be ignored. to the job log and its event log (output0.log).
Local fix
To workaround this issue, edit the properties file for either the agent or database logger that is reporting the BFGUB0078W warning message, and remove the line: CLEAN_AGENT_PROPS=<value>
Problem summary
**************************************************************** USERS AFFECTED: This issue affects users of IBM MQ Managed File Transfer for z/OS who use the sample dataset SBFGCMDS to create and administer agents and database loggers. Platforms affected: z/OS **************************************************************** PROBLEM DESCRIPTION: The BFGCUSTM member within the SBFGCMDS PDSE provided by IBM MQ Managed File Transfer for z/OS is used to create a set of customized members which can be used to configure and administer an IBM MQ Managed File Transfer topology. The BFGCUSTM member is split into three distinct sections: - The "Variables" section contains a list of environment variables that are used when creating the customized members for Managed File Transfer commands. - The second section, "Properties", is used to hold additional properties that will be added to properties files when various customized members are run. - The final section is called "Environment". This section holds environment variables that are set when the customized members are run. The variable CLEAN_AGENT_PROPS within the BFGCUSTM member is used to specify the arguments that should be used when cleaning an agent within the customized BFGAGCL member. Unfortunately, the CLEAN_AGENT_PROPS variable was incorrectly specified in the "Properties" section of BFGCUSTM. As a result, the following behaviour would occur: *********************************************************** If BFGCUSTM was configured to create an agent: --------------------------------------------------- When the BFGAGCR member was run to create an agent, the member would create an agent.properties file for the agent that contained the entry: CLEAN_AGENT_PROPS=<value> When the agent was started using the BFGAGSTP procedure, it would write the warning: BFGUB0078W: The property name "CLEAN_AGENT_PROPS" in file "agent.properties" of "<agent name>" is not a valid MQMFT property and will be ignored. to the job log and the agent's event log (also known as the output0.log file). *********************************************************** If BFGCUSTM was configured to create a database logger: ------------------------------------------------------- When a database logger was created using the the BFGLGCR member, the entry: CLEAN_AGENT_PROPS=<value> was incorrectly added to the database logger's logger.properties file. When the logger was subsequently started using the BFGLGSTP procedure, the warning message: BFGUB0078W: The property name "CLEAN_AGENT_PROPS" in file "logger.properties" of "<logger name>" is not a valid MQMFT property and will be ignored. was written to the job log and the logger's event log (output0.log).
Problem conclusion
The BFGCUSTM member within the SBFGCMDS PDSE has been updated so that the CLEAN_AGENT_PROPS variable is now specified in the "Variables" section, rather than the "Properties" section. As a result: - When the BFGCUSTM member is run to create customized members for an agent or a logger, it will only update the BFGAGCL member. - If the BFGCUSTM member is used to create customized JCL for an agent, then the entry: CLEAN_AGENT_PROPS=<value> will no longer be added to the agent.properties file when the BFGAGCR member is run. This means that the agent will not report the warning: BFGUB0078W: The property name "CLEAN_AGENT_PROPS" in file "agent.properties" of "<agent name>" is not a valid MQMFT property and will be ignored. when it is started by the BFGAGSTP procedure. - If the BFGCUSTM member is used to create some customized JCL for a database logger, then when the BFGLGCR member is run it will not add the entry: CLEAN_AGENT_PROPS=<value> to the database logger's logger.properties file. This means that the database logger will start without reporting the warning message: BFGUB0078W: The property name "CLEAN_AGENT_PROPS" in file "logger.properties" of "<logger name>" is not a valid MQMFT property and will be ignored. --------------------------------------------------------------- The fix is targeted for delivery in the following PTFs: Version Maintenance Level v9.1 CD 9.1.2 v9.1 LTS 9.1.0.2 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
PH06012
Reported component name
IBM MQ MFT Z/OS
Reported component ID
5655MF900
Reported release
900
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2018-12-02
Closed date
2018-12-10
Last modified date
2018-12-10
APAR is sysrouted FROM one or more of the following:
PH05971
APAR is sysrouted TO one or more of the following:
Fix information
Fixed component name
IBM MQ MFT Z/OS
Fixed component ID
5655MF900
Applicable component levels
[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]
Document Information
Modified date:
10 December 2018