PK28757: ENHANCEMENTS TO THE APPLICATION TRACE FACILITY (ATF)

Obtain the fix for this APAR.

APAR status

• Closed as unreproducible in next release.

Error description

• This APAR will add to the functionality of ATF processing in two
  ways.
  1) A new option "FLUSH=" has been added to the ATF options
  screen, ATRQ. The FLUSH option specifies the frequency (in
  seconds) at which ATF processing will write its internal buffers
  to the VSAM trace dataset.
  2) The maximum value of the overall tracing interval has been
  increased in screen ATRQ. The value can now be specified for
  a period of up to 9998 minutes. Additionally, an
  unlimited trace interval can be indicated by specifying a TIME
  value of either 1440 or 9999. In order to enable this feature,
  usermod KO2MOD01 must be installed.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of OMEGAMON XE for DB2 PE/DB2PM V310   *
  ****************************************************************
  * PROBLEM DESCRIPTION: Allow for unlimited trace interval.     *
  *                      Externalize FLUSH interval.             *
  ****************************************************************
  * RECOMMENDATION: Apply this PTF                               *
  ****************************************************************
  Enhancement
  

Problem conclusion

Temporary fix

Comments

• Enhancement:
  The usermod permits changes to the defaults and maximums
  used by ATF processing. One of those maximums is the
  maximum trace interval, which affects the 'TIME=' field
  on screen ZATRQ.
  By default, this maximum is 60 minutes. If you are happy
  with this limit then no further action is required after
  installing the PTF.
  However, in order to allow for unlimited tracing by users,
  USERMOD KO2MOD01 must be applied, and the maximum
  trace time value set to 9999. The updated USERMOD is found
  in the hilev.TKANSAM library. These actions are described
  in detail within the USERMOD itself. Once the USERMOD
  has been applied, users can then specify on screen ZATRQ
  either 1440 or 9999 to indicate an unlimited trace time,
  or any other value, which will be interpreted as an exact
  number of minutes.
  ----------------------
  SYSMOD Title: Enhancements to ATF processing
  Keywords:     ATF FLUSH TIME INTERVAL
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UK17747

Modules/Macros

•    KD2PSA2P KD2UTDCL KO2ACAFS KO2ACAF2 KO2ACAPS
  KO2ACAP2 KO2ASUBS KO2ASUB2 KO2ATRCB KO2ATRPB KO2ATRQH KO2ATVWH
  KO2AUSRB KO2CNTPS KO2CNTP2 KO2ICAFS KO2ICAF2 KO2MOD01 KO2ODCNB
  KO2OTHDB
  

Fix information

• Fixed component name

  OM XE DB2PE/PM

• Fixed component ID

  5655OPE00

Applicable component levels

• R310 PSY UK17747

     UP06/09/16 P F609

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.