IBM Support

PH06012: Agent or logger report a BFGUB0078W warning message indicatingthat CLEAN_AGENT_PROPS is not a valid prope

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 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