IBM Support

PI79279: Correct SCRT reporting for MQ MFT Advanced and Advanced VUE

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

  • Correct SCRT reporting for MQ Managed File Transfer (MFT)
    Advanced and Advanced VUE
    
    Additional keywords:
    5655AV900 5655AV100 5655AM900
    

Local fix

  • N/A
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects all users of IBM MQ Managed File Transfer for
    z/OS Version 9 Release 0 Modification 0.
    
    
    Platforms affected:
    z/OS
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    When MQ Managed File Transfer generated SMF89 records for SCRT
    reporting, the records always contained the base product
    identifier (PID), 5655-MF9.
    
    When running under the MQ Advanced or MQ Advanced VUE software
    bundles the SMF89 records should have contained the MQ Advanced
    or MQ Advanced VUE PID instead:
    MQ Advanced - 5655-AV9
    MQ Advanced VUE - 5655-AV1
    

Problem conclusion

  • This APAR removes the need to manually annotate SCRT reports for
    MQ Managed File Transfer to indicate use of an MQ software
    bundle.
    
    A new configuration property "productId" has been added to allow
    the PID recorded to be overridden.  This property specifies the
    type of PID against which MQ Managed File Transfer usage is to
    be recorded. The value for productId can be set by running the
    new fteSetProductId command (which has been introduced as part
    of this APAR) specifying one of the values described below:
    
    ************************************************************
    Value: MFT
    Description: Managed File Transfer is a standalone MQ for z/OS
    product, with product ID 5655-MF9. This is the default value.
    
    Value: Advanced
    Description: Managed File Transfer is part of an IBM MQ Advanced
    for z/OS product, with product ID 5655-AV9.
    
    Value: AdvancedVue
    Description: Managed File Transfer is part of an IBM MQ Advanced
    for z/OS, Value Unit Edition product, with product ID 5655-AV1.
    ************************************************************
    
    The value specified is stored in the MQ Managed File Transfer
    configuration file installation.properties
    
    Unless running MQ Advanced or MQ Advanced VUE the default value
    can be used.
    
    Note that fteSetProductId should only be run after at least one
    coordination queue manager has been defined.
    
    fteDisplayVersion -v has been updated to display the product id,
    if run on z/OS and the product id has been specified.
    
    
    For information on the new productId property and the
    fteSetProductId command, refer to the following topics in the MQ
    V9 section of IBM MQ Knowledge Center:
    
    Topic: Product usage recording with IBM MQ for z/OS products
    URI:
    https://www.ibm.com/support/knowledgecenter/en/SSFKSJ_9.0.0/com.
    ibm.mq.ins.doc/q009700_.htm
    
    fteSetProductId (set z/OS SCRT recording product id)
    https://www.ibm.com/support/knowledgecenter/en/SSFKSJ_9.0.0/com.
    ibm.wmqfte.doc/set_productid_cmd.htm
    
    
    New message have been added to MQ Managed File Transfer by this
    APAR, and some existing messages have been updated. Information
    about these messages can be found below:
    
    Managed File Transfer diagnostic messages BFGPR0001 - BFGPR9999
    https://www.ibm.com/support/knowledgecenter/en/SSFKSJ_9.0.0/com.
    ibm.wmqfte.messages.doc/fte_bfgpr.htm
    
     BFGPR0137I
     Product usage data recording started for product
    ''<insert_0>'', product id ''<insert_1>''.
     Severity
     0 : Information
     Explanation
     IBM MQ usage recording will be for product ''{0}''.
     Response
     No user action required.
    
     BFGPR0140I
     Product usage data is not being recording for product
    ''<insert_0>'', product id ''<insert_1>''.
     Severity
     0 : Information
     Explanation
     IBM MQ usage recording will not be collected for product
    ''{0}''. Thismay be because usage recording is not active on the
    system.
     Response
     No user action required.
    
     BFGPR0136E
     Internal error: ''<insert_0>'' is not valid for productId.
     Severity
     20 : Error
     Explanation
     An internal error has occurred attempting while attempting to
    register for SCRT usage recording.
     Response
     If the problem persists, see problem determination information
    in the product documentation.
    
     BFGPR0138W
     Product usage data already being recorded for product
    ''<insert_0>'', product id ''<insert_1>''.
     Severity
     10 : Warning
     Explanation
     The product attempted to start product usage data recording for
    product ''{0}'', but it was already started. This may not be a
    problem.
     Response
     No user action required if there are no other issues with usage
    data recording.
    
     BFGPR0139E
     Internal error: Product usage data cannot be recorded because
    the limit on product registrations has been reached for the
    address space.
     Severity
     20 : Error
     Explanation
     The product attempted to start product usage data recording for
    product ''{0}'', product id ''{1}'', which failed.
     Response
     CMSG002
    
    <a
    href="https://www.ibm.com/support/knowledgecenter/SSFKSJ_9.0.0/c
    om.ibm.wmqfte.messages.doc/messages_main.htm">Managed File
    Transfer diagnostic messages</a> :BFGCL0001 - BFGCL9999
    https://www.ibm.com/support/knowledgecenter/SSFKSJ_9.0.0/com.ibm
    .wmqfte.messages.doc/fte_bfgcl.htm
    
     BFGCL0757E
     Invalid command options. Specify either logAgent or logMonitor
    option but not both.
     Severity
     20 : Error
     Explanation
     The specified option is not valid for the command. Specify
    either logAgent or logMonitor option but not both.
     Response
     Specify valid command option.
    
     BFGCL0753E
     A productId must be specified when setting the productId.
     Severity
     20 : Error
     Explanation
     You cannot set the productId without specifying the value to
    which you want to set it.
     Response
     Specify the '-h' parameter to display usage information about
    the command.
    
     BFGCL0754I
     The specified productId ''<insert_0>'' is already being used.
    No changes have been made.
     Severity
     0 : Information
     Explanation
     The specified productId is already being used. No changes have
    been made.
     Response
     No action required.
    
     BFGCL0755I
     The specified productId ''<insert_0>'' has been set.
     Severity
     0 : Information
     Explanation
     The specified productId has been set.
     Response
     No action required.
    
    <a
    href="https://www.ibm.com/support/knowledgecenter/SSFKSJ_9.0.0/c
    om.ibm.wmqfte.messages.doc/messages_main.htm">Managed File
    Transfer diagnostic messages</a> : BFGUB0001 - BFGUB9999
    https://www.ibm.com/support/knowledgecenter/SSFKSJ_9.0.0/com.ibm
    .wmqfte.messages.doc/fte_bfgub.htm
    
     BFGUB0065E
     The property name "<insert_0>" has an invalid value of
    "<insert_1>". The valid values are "<insert_2>".
     Severity
     20 : Error
     Explanation
     The named property must be a valid value for the command to
    successfully complete.
     Response
     Review the associated property file and change the property so
    that is has a valid value.
    
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v9.0 CD    9.0.3
    v9.0 LTS   9.0.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

    PI79279

  • Reported component name

    MQ MFT Z/OS V9

  • Reported component ID

    5655MF900

  • Reported release

    900

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-04-04

  • Closed date

    2017-08-24

  • Last modified date

    2017-08-24

  • 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

    MQ MFT Z/OS V9

  • Fixed component ID

    5655MF900

Applicable component levels

  • R900 PSY

       UP

[{"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":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
24 August 2017