PM31179: KO2O1348E NEAR-TERM HISTORY DATA COLLECTOR - READA/READS FAILED.REASON CODE 00E60826 (CHECKRET).

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• KO2O1348E NEAR-TERM HISTORY DATA COLLECTOR - READA/READS FAILED.
  REASON CODE 00E60826 (CHECKRET).
  
  Near-Term History failed to be started and received the message
  of KO2O1348E NEAR-TERM HISTORY DATA COLLECTOR - READA/READS
  FAILED.  REASON CODE 00E60826 (CHECKRET).
  
  we should say it's mandatory for ACCTG Class 1: Y.
  
  e.g.
  D2#6 job:
  *
  STATISTICS(YES)
  SCAN(NO)
  SORT(NO)
  *
  FYI.
  KD261MC2    Specify OMEGAMON XE for DB2 PE Subsystem
  RTE:  SYSG ----
  Option ===>
                        DB2 Subsystem ID: D71D
   Select one or more options to configure OMEGAMON XE for DB2
  Performance
   Expert on z/OS. To update the entire configuration, type ALL.
  To update
   specific values, select the corresponding options from the
  list.
  
  Last  selected
  
  Date  Time
    1  DB2 subsystem information                    (mandatory)
    2  Object/Volume Analysis configuration         (mandatory)
    3  Application Trace Facility configuration
    4  Automatic Exception Processing configuration
    5  Near Term Historical Collector configuration (mandatory)
    6  Snapshot History configuration
    7  Performance Warehouse configuration
    8  DB2 EXPLAIN configuration
    9  SQL Performance Analyzer configuration
    Note: Options highlighted as mandatory require configuration.
   F1=Help  F3=Back
  
  KD261PB  OMEGAMON XE for DB2 PE Near Term History configuration
  SSID:  D71D
  Command ===>
   Specify which data should be collected:
    Scan summary      ==> N     Sort summary      ==> N
    Dynamic SQL       ==> N     Lock contention   ==> N
    Lock suspension   ==> N     Statistics        ==> Y
    Negative SQL      ==> N
    Acctg class  ==> 1: N   2: N   3: N   7: N   8: N   10: N
  

Local fix

• It's mandatory for ACCTG Class 1: Y.  Set ACCTG(1) via ICAT
  process.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: OMEGAMON XE for DB2 PE/DB2PM                 *
  *                 users of component:                          *
  *                 -   OMEGAMON collector                       *
  ****************************************************************
  * PROBLEM DESCRIPTION: 1. READA failure with reason code       *
  *                      00E60826                                *
  *                      2. PERFORMANCE CLASS 1 IS SPECIFIED ON  *
  *                      ALL -START TRACE PERFORMANCE COMMANDS.  *
  *                                                              *
  ****************************************************************
  * RECOMMENDATION: Apply this PTF                               *
  *                                                              *
  ****************************************************************
  PROBLEM SUMMARY:
  1. NTH COLLECTOR FAILS WITH 00E60826 CODE BECAUSE NO START
  TRACE COMMANDS ARE ISSUED TO ESTABLISH A VALID OPx BUFFER.
  2. PERFORMANCE CLASS 1 ADDS ADDITIONAL IFCIDS TO THE
  PERFORMANCE TRACE, WHICH ARE NOT REQUIRED.
  
  PROBLEM CONCLUSION:
  1. MODIFY CODE TO SKIP READA REQUEST WHEN NO OPx BUFFER HAS
  BEEN ESTABLISHED.
  2. MODIFY CODE TO PREVENT START OF PERFORMANCE CLASS 1 WHEN
  IT IS NOT REQUIRED.
  

Problem conclusion

• 1. MODIFY CODE TO SKIP READA REQUEST WHEN NO OPx BUFFER HAS
  BEEN ESTABLISHED.
  2. MODIFY CODE TO PREVENT START OF PERFORMANCE CLASS 1 WHEN
  IT IS NOT REQUIRED.
  
  KEYWORDS : READA 00E60826 NTH NEAR TERM HISTORY
             PERFORMANCE CLASS 1
  

Temporary fix

Comments

APAR Information

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

  PK84992

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

  UK75708 PM71041

Modules/Macros

•    KO2HPR1B KO2ICOLA KO2ICOLK KO2ICOL2
  

Fix information

• Fixed component name

  OM XE DB2PE/PM

• Fixed component ID

  5655OPE00

Applicable component levels

• R510 PSY UK75708

     UP12/01/27 P F201

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.