PI61267: KO2H0001W XXXX NEAR-TERM HISTORY DATA COLLECTOR - COLLECTION DB2NOT ACTIVE. WAIT, OR REPLY ANOTHER DB2 ID, OR REPLY STOP

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• If the Near-term history feature is started and the respective
  DB2 for z/OS sub system is not active, Omegamon will issue
  the following WTOR even though no reply is required
  KO2H0001W xxxx NEAR-TERM HISTORY DATA COLLECTOR - COLLECTION
      DB2 NOT ACTIVE. WAIT, OR REPLY ANOTHER DB2 ID, OR REPLY STOP
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: OMEGAMON XE for DB2 PE/DB2PM                 *
  *                 users of component                           *
  *                 - NTH - Near Term History                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: KO2H0001W WTOR issued during Near Term  *
  *                      History (NTH) startup when no reply is  *
  *                      required.                               *
  ****************************************************************
  * RECOMMENDATION: Apply this PTF.                              *
  ****************************************************************
  PROBLEM SUMMARY:
  During Near Term History (NTH) startup, a KO2H0001W WTOR will
  be issued and collection for the DB2 subsystem will wait until
  DB2 is active and discovered.  The user can reply to the WTOR
  to have NTH collection changed to a different DB2 subsystem or
  to stop the NTH collection task.  If no reply is given to the
  WTOR, the WTOR will be deleted when the DB2 subsystem is
  discovered or when the started task is shut down.  Although
  no reply is needed, an option is being provided to bypass
  issuing the WTOR and to have the NTH collector wait until
  the DB2 subsystem comes up.
  
  PROBLEM CONCLUSION:
  A new parameter is added to the RKD2PAR member OMPEOPTS.  Add
  the following to RKD2PAR(OMPEOPTS) to have NTH startup bypass
  issuing the KO2H0001W WTOR.
  
  NTHDB2I=WAIT
  
  The KO2H0001W WTOR may be issued if the NTHDB2I parameter is
  not specified, or if NTHDB2I=WTOR has been specified.
  If the NTHDB2I parameter is specified with a value not being
  valid (anything other than WAIT or WTOR), the following new
  error message will be issued:
  
  KO2H0904U NEAR-TERM HISTORY - THE NTHDB2I REAL-TIME OPTION
  SPECIFIED IS NOT VALID. NTHDB2I=WTOR DEFAULT USED. (H2INIT)
  
  Explanation:
  The value specified with the NTHDB2I parameter in the OMPEOPTS
  member of RKD2PAR is not valid. Valid values are WTOR or WAIT.
  
  System Action:
  Processing continues with the default value of WTOR.
  
  KEYWORDS:
  MSGKO2H0001W MSGKO2H0904U
  

Problem conclusion

• A new parameter is added to the RKD2PAR member OMPEOPTS.  Add
  the following to RKD2PAR(OMPEOPTS) to have NTH startup bypass
  issuing the KO2H0001W WTOR.
  
  NTHDB2I=WAIT
  
  The KO2H0001W WTOR may be issued if the NTHDB2I parameter is
  not specified, or if NTHDB2I=WTOR has been specified.
  If the NTHDB2I parameter is specified with a value not being
  valid (anything other than WAIT or WTOR), the following new
  error message will be issued:
  
  KO2H0904U NEAR-TERM HISTORY - THE NTHDB2I REAL-TIME OPTION
  SPECIFIED IS NOT VALID. NTHDB2I=WTOR DEFAULT USED. (H2INIT)
  
  Explanation:
  The value specified with the NTHDB2I parameter in the OMPEOPTS
  member of RKD2PAR is not valid. Valid values are WTOR or WAIT.
  
  System Action:
  Processing continues with the default value of WTOR.
  

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:

  UI39490

Modules/Macros

• KO2CNSRB KO2DDSBA KO2DDSBK KO2DDSBS KO2DNTHA KO2DNTHK KO2DNTHS
  KO2HDTIB KO2HDTPB KO2HINTB KO2HPR1B KO2HSQIB KO2HSVIB KO2HTRMB
  KO2HVINB KO2HWLMB KO2ICOLA KO2ICOLK KO2ICOLS KO2IINTB KO2LCAPB
  KO2ODBGB KO2ORCVB KO2OSBSB KO2ZASI  KO2ZAST  KO2ZASY  KO2ZCMD
  KO2ZCTB  KO2ZDIA  KO2ZEOM  KO2ZEOT  KO2ZFCT  KO2ZFRR  KO2ZGSL
  KO2ZISX  KO2ZLCK  KO2ZMAT  KO2ZRTG  KO2ZRTM  KO2ZRTO  KO2ZSUB
  KO2ZSVC  KO2ZTMR  KO2ZVCB  KO2ZVCZ  KO2ZWTO  KO2ZXDQ  KO2ZXGP
  KO2ZXMT  KO2ZXNO  KO2ZXQR  KO2ZXRB  KO2ZXRD  KO2ZXRE  KO2ZXRM
  KO2ZXRR  KO2ZXST  KO2ZXYZ  KO2ZZPC  KO2ZZPT  KO2ZZRR  KO2ZZSM
  KO2ZZSR
  

Fix information

• Fixed component name

  OM XE DB2PE/PM

• Fixed component ID

  5655OPE00

Applicable component levels

• R530 PSY UI39490

     UP16/07/22 P F607

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.