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

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