PK48849: NTH CLEANUP (REMOVE AUDIT/ZPARM OPTIONS)

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• NTH cleanup (remove Audit/ZPARM options)
  

Local fix

• Note: Once ptf is applied user needs to pre-allocated the
  sequential datasets, unless they specify a GDG (+1) or used the
  @date @time feature to create a new dataset name.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: OMEGAMON XE for DB2 PE/DB2PM                 *
  *                 users of component:                          *
  *                 -   OMEGAMON Server                          *
  *                 -   Classic Interface                        *
  *                 -   ICAT                                     *
  ****************************************************************
  * PROBLEM DESCRIPTION: 1. NTH collector options AUDIT,         *
  *                         ZPARM, ARCHIVEJCL, COMMIT,           *
  *                         DB2SYSWRITE, DSNZPARM and IFCID are  *
  *                         obsolete/no longer supported.        *
  *                      2. Reinstate NTH VSAM,SEQ sequential    *
  *                         option in ICAT and NTH collector.    *
  *                      3. The option to collect NTH data for   *
  *                         Negative SQL return codes is missing *
  *                         in ICAT.                             *
  *                      4. Entry ArchiveSEQ in panel ZH2IN      *
  *                         shows an invalid member name.        *
  *                      5. The job generated for Static         *
  *                         Sequential Archiving causes a JCL    *
  *                         error.                               *
  *                      6. The Static Sequential Archiving job  *
  *                         uses only the first data set for     *
  *                         archiving.                           *
  *                      7. Message KO2O0555I is inaccurate and  *
  *                         message KO2H1379I contains an        *
  *                         invalid word.                        *
  *                      8. If no DB2 subsystem is configured    *
  *                         and you select option 4 'Allocate    *
  *                         additional runtime data sets' the    *
  *                         following error message is displayed *
  *                      *************************************** *
  *                      KCICTALR FATAL ERROR DETECTED, RC = 20  *
  *                      KCICTALR FUNCTION: FTINCL KD2610R1      *
  *                      KCICTALR Service error                  *
  *                      KCICTALR RC 8 from TBOPEN, KD2610R1     *
  *                      record-15                               *
  *                      *************************************** *
  ****************************************************************
  * RECOMMENDATION: Apply this PTF                               *
  ****************************************************************
  PROBLEM SUMMARY:
  1. The code has been changed to disallow the specification of
     the following keywords in rHilev.RKD2PAR(COPT<ssid>):
     AUDIT, ZPARM, ARCHIVEJCL, COMMIT, DB2SYSWRITE, DSNZPARM and
     IFCID.
     In conjunction with this change the NTH collector and the
     VTAM panels ZH2IN and ZH2RC have been changed to reflect the
     changes mentioned above in the rHilev.RKD2PAR(COPT<ssid>)
     members.
  2. Reinstate NTH sequential option SEQ in addition to VSAM
     option in ICAT, NTH collector and VTAM panel ZH2IN. The files
     produced by the SEQ option can be used in the INPUTDD DD
     statement of the Batch reporter in order to generate reports.
  3. The option to collect NTH data for Negative SQL return codes
     has been added to ICAT and VTAM panel ZH2IN.
  4. Entry ArchiveSEQ in panel ZH2IN shows an invalid member
     name.
  5. The job generated for Static Sequential Archiving causes a
     JCL error.
  6. The Static Sequential Archiving job uses only the first data
     set for archiving.
  7. Message KO2O0555I is inaccurate. The thrown message KO2H1379I
     contains an invalid word.
  8. If no DB2 subsystem is configured and you select option 4
     'Allocate additional runtime data sets' a fatal error occurs
  
  PROBLEM CONCLUSION:
  1. The code has been changed to disallow the specification of
     the following keywords in rHilev.RKD2PAR(COPT<ssid>):
     AUDIT, ZPARM, ARCHIVEJCL, COMMIT, DB2SYSWRITE, DSNZPARM and
     IFCID. Message KO2H1406W will be issued in this case.
     In conjunction with this change the NTH collector and the
     VTAM panels ZH2IN and ZH2RC have been changed to reflect the
     changes mentioned above in the rHilev.RKD2PAR(COPT<ssid>)
     members.
  2. Reinstate NTH sequential option SEQ in addition to VSAM
     option in ICAT, NTH collector and VTAM panel ZH2IN. The files
     produced by the SEQ option can be used in the INPUTDD DD
     statement of the Batch reporter and Performance Warehouse
     Report step in order to generate reports.
     The online sequential files of type "static sequential"
     cannot be used directly for reporting. Use the produced
     archive dynamic or GDG sequential files instead.
  3. The option to collect NTH data for Negative SQL return codes
     has been added to ICAT and VTAM panel ZH2IN.
  4. Code has been changed.
  5. Code has been changed.
  6. Code has been changed.
  7. The message texts have been changed.
  8. A message is displayed that tells you to configure a DB2
     subsystem.
  

Problem conclusion

• 1. The code has been changed to disallow the specification of
     the following keywords in rHilev.RKD2PAR(COPT<ssid>):
     AUDIT, ZPARM, ARCHIVEJCL, COMMIT, DB2SYSWRITE, DSNZPARM and
     IFCID. Message KO2H1406W will be issued in this case.
     In conjunction with this change the NTH collector and the
     VTAM panels ZH2IN and ZH2RC have been changed to reflect the
     changes mentioned above in the rHilev.RKD2PAR(COPT<ssid>)
     members.
  2. Reinstate NTH sequential option SEQ in addition to VSAM
     option in ICAT, NTH collector and VTAM panel ZH2IN. The files
     produced by the SEQ option can be used in the INPUTDD DD
     statement of the Batch reporter and Performance Warehouse
     Report step in order to generate reports.
     The online sequential files of type "static sequential"
     cannot be used directly for reporting. Use the produced
     archive dynamic or GDG sequential files instead.
  3. The option to collect NTH data for Negative SQL return codes
     has been added to ICAT and VTAM panel ZH2IN.
  4. Code has been changed.
  5. Code has been changed.
  6. Code has been changed.
  7. The message texts have been changed.
  8. A message is displayed that tells you to configure a DB2
     subsystem.
  
  KEYWORDS : ICAT IFIREADTIME MAX VALUE NTH VSAMSEQ SEQ SEQUENTIAL
  NEGATIVE SQL BATCH REPORTER ARCHIVING ARCHIVESEQ KO2O0555I
  KO2H1379I ZH2IN ZH2RC KO2H1406W KO2O1367I KO2O1366I
  

Temporary fix

Comments

• ×**** PE08/07/03 FIX IN ERROR. SEE APAR PK66921  FOR DESCRIPTION
  

APAR Information

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

  PK27509

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

  UK35917

Modules/Macros

•    KDBZC01  KDBZC02  KDBZC03  KDBZC05  KD2BHELP
  KD2CTBEX KD2CVAR2 KD2DDICT KD2SBATO KD261CAT KD261CB2 KD261CCB
  KD261CNH KD261CPT KD261CUM KD261CXL KD261CXT KD261HD  KD261HT
  KD261HTA KD261HTB KD261HTC KD261HTJ KD261HTK KD261HTL KD261HTT
  KD261HTU KD261HTV KD261HTW KD261HT4 KD261HT5 KD261HT6 KD261HV
  KD261HVA KD261HVB KD261HVJ KD261HVK KD261HVL KD261HVM KD261HVN
  KD261H0  KD261H0A KD261H0B KD261H0C KD261H0D KD261H9  KD261H9A
  KD261H9B KD261H9C KD261PB  KD261PD  KD261PX  KD261PY  KD261PZA
  KD261PZ1 KD261PZ2 KD261PZ3 KD261P7  KD261P8  KD261SJ6 KD261SN1
  KD261SN2 KD2610R1 KD2610SP KO2$QIOB KO2ACAPA KO2ACAPS KO2ACAP2
  KO2CMVSC KO2CMVSF KO2CNSRB KO2DAUDA KO2DAUDS KO2DAUD2 KO2DCS2B
  KO2DDSBA KO2DDSBS KO2DDSB2 KO2DMSCA KO2DMSCS KO2DMSC2 KO2DTHDA
  KO2DTHDS KO2DTHD2 KO2DXSTB KO2DXS1A KO2DXS1S KO2DXS12 KO2DXS2A
  KO2DXS2S KO2DXS22 KO2HARCB KO2HDTIB KO2HDTPB KO2HINTB KO2HMSGB
  KO2HPRCB KO2HPR1B KO2HPR2B KO2HSMDH KO2HSMSH KO2HSQIB KO2HSQPB
  KO2HVINB KO2HWLMB KO2H2DSH KO2H2INH KO2H2RCH KO2ICOLA KO2ICOLS
  KO2ICOL2 KO2IINTB KO2LCAPB KO2OH2IB KO2OMGCB KO2ONAGB KO2ONTAB
  KO2PCTCC KO2PCTCF KO2PCTOC KO2PCTOF KO2PDRVC KO2PDRVF KO2PMEMC
  KO2PMEMF KO2PUTLC KO2PUTLF KO2TIOSB KO2TSB1B KO2TSB2B KO2TSB3B
  KO2TSB4B KO2WGETB
  

Fix information

• Fixed component name

  OM XE DB2PE/PM

• Fixed component ID

  5655OPE00

Applicable component levels

• R410 PSY UK35917

     UP08/05/17 P F805

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.