Professional Documents
Culture Documents
Users Affected:
USERS AFFECTED: IBM Db2 Query Monitor z/OS
users of component
- Documentation - Public use
- CQM Data Collector
Enter here . . .
V01 - 10/10/2018 ROCKET SOFTWARE INC, FOR INTERNAL USE ONLY Page 1
APAR RESPONDER PAGE
Search Keywords:
Note: ‘Search Keywords:’ line in ‘Problem Conclusion’ box should be fixed. For readability
and consistency, add your keywords to the line below ‘Search keywords:’
None.
None.
HOLD DESCRIPTION
HOLD(DOC)
****************************************************************
* FUNCTION AFFECTED: DB2 Query Monitor (PH35973) *
****************************************************************
* DESCRIPTION : Installation notes *
****************************************************************
* TIMING : As Needed *
****************************************************************
|Changed the algorithm for reading record by key |
|from the SQLCD file.
|
| |
| After the fix is applied rebind of CQM DB2 plan should be |
| done. |
| |
|--------------------------------------------------------------|
++IF REQ
PRE REQ
V01 - 10/10/2018 ROCKET SOFTWARE INC, FOR INTERNAL USE ONLY Page 3
CQMWENU
DBRMLIB/SCQMDBRM
DENULIB/SCQMDENU
HFSBIN
HFSCLS
HFSLIB
ISPMLIB/SCQMMENU
ISPPLIB/SCQMPENU
ISPSLIB
OBJLIB/ACQMLOAD
SAMPLIB/SCQMSAMP
QUERY/SCQMQRY
FORM/SCQMFORM
TRANSFER
JCLIN
V01 - 10/10/2018 ROCKET SOFTWARE INC, FOR INTERNAL USE ONLY Page 4
LEGAL CHECKLIST
☐ Yes ☒ No 1. Does this fix contain any code licensed from third party (other than open source)?
☐ yes ☐ no 1a Do you have legal approval for shipping this version of the third party
code in the maintenance stream?
☐ yes ☐ no 1b. Does this shipping of third party code require entitlement?
☐ Yes ☒ No 2. Does this fix contain any open source?
☐ yes ☐ no 2a. Do you have OSSC approval for shipping this version of open source in
the maintenance stream.
☐ yes ☐ no 2b. Is the open source being distributed in accordance with any restrictions
imposed by legal or the OSSC?
☐ yes☐ no 2c. Does the shipping of open source require entitlement?
YES => Stop Process. Project management needs to be involved
☐ Yes ☒ No 3. Does this fix contain any License or master keys
☐ yes ☐ no 3a. Has legal approved shipping the keys?
YES=> Please contact Project Management
☐ yes ☐ no 3b. Does the shipping of license or master keys require entitlement?
YES=. Stop Process. Project management needs to be involved.
☐ Yes ☒ No 4. Does this fix, or this fix in combination with other fixes, enable functionality that
only entitled customers should have? For example, full product included.
☐ Yes ☒ No 5. Is this fix subject to any export restrictions due to its content such as encryption,
sensitive content or because of any other export requirements?
☒ Yes ☐ No 6. If removing document function/API’s in this fix, have you received approval
through your organizations official approval process?
(Answer YES if you are not removing documented function/APIs)
☐ Yes ☒ No 7. Does this fix, or any customer visible documentation about fix, contain any IBM,
Rocket Software or client sensitive/confidential information?
(i.e., username, password or personally identifiable information)
V01 - 10/10/2018 ROCKET SOFTWARE INC, FOR INTERNAL USE ONLY Page 5
IBM Db2 Query Monitor z/OS Components Affected:
☐ CAE - Compare ☐ Compatibility
☐ CAE - DSM - Data Studio/OQWT ☐ Concurrent Related (STAP/OMPE)
☐ CAE - EO (HostVar Collection) ☐ CQM Data Collector
☐ CAE - OMPE Integration ☒ CQM Data Offload and Batch Reporting
☐ CAE - Windows Installer ☐ Current Activity
☐ CAE Accessibility ☐ Data Sharing
☐ CAE Agent & Networking ☐ Help and Messaging
☐ CAE Alerts ☐ Host Variables
☐ CAE Archive Connections ☐ IDAA Acceleration/Modeling
☐ CAE Data Charts ☐ Intervals
☐ CAE Export ☐ ISPF Client
☐ CAE KBM ☐ Parallel Activity
☐ CAE Navigation/Drill downs/Formatting ☐ RACF or Security or Authentication
☐ CAE QM Subsys Mgmt ☐ SQL Codes
☐ CAE Reorg Avoidance ☐ SQL Text
☐ CAE Server ☐ Statistics
☐ CAE USS Server Setup/Migration/Scripts ☐ Summaries
☐ TCz ☐ Exceptions
☐ Installation and customization ☐ Profiles
☐ Documentation - Public use ☐ Discovery
Global Areas:
☐ ISPF/FEC - only client
☐ DSECT
☐ Collector fixes
☐ Offload
☐ CAE Server
☐ CAE Agent
☐ CAE Web client
☐ TCz
V01 - 10/10/2018 ROCKET SOFTWARE INC, FOR INTERNAL USE ONLY Page 6
Inspection Schedule
Date / Day
Time Via Git pull request
Description Problems loading Query Monitor data into history table
Author Valeri Troufanov
Component Owner Stepan Minchenkov
Inspectors Stepan Minchenkov
V01 - 10/10/2018 ROCKET SOFTWARE INC, FOR INTERNAL USE ONLY Page 7
INSPECTION OVERVIEW
Problem Overview
Customer reported that:
The load jobs of the CQM registers in DB2 for z/OS are
presenting a very large difference in run-time, with a
difference in the amount of records that does not justify this
increase in run-time.
The problem was:
1. Reading the SQLCD interval file to the end of the file
after each reading the record by key operation from the
given file.
2. For each reading the record by key operation for this file
the functions of opening and closing the data set were
performed.
Fixed a bug:
Changed the algorithm for reading record by key from the SQLCD
file.
Resolution
This PTF next change:
Inspection Items
/proj/CQM/V330/CQM19347/cqm/ASM/
CQM@WDB2, CQM#IVSM
/proj/CQM/V330/CQM19347/cqm/MACLIB/
$DB2TAB, $VSAMREQ, CQM#IVSM
V01 - 10/10/2018 ROCKET SOFTWARE INC, FOR INTERNAL USE ONLY Page 8
INSPECTION CHECKLIST
Inspection:
☐ Yes ☒ No SYSROUTE’s Needed SYSROUTE Number:
☒ Yes ☐ No Are changes properly tagged?
☒ Yes ☐ No Are published Standards and Best practices adhered to?
https://wiki.rocketsoftware.com/display/OMPE/OMEGAMON+Standards+and+Best+Practices
☐ Yes ☒ No Does this change impact the customers TCz Environment or configuration?
☒ Yes ☐ No Documentation changes included for the inspection?
☒ Yes ☐ No ++HOLD required? E.g. messages, commands, parameter options, etc.
☒ Yes ☐ No Reviewed for PSP or HIPER applicability?
☐ Yes ☒ No HIPER
☐ Yes ☒ No PSP
☒ Yes ☐ No APAR RETAIN text been reviewed and updated?
☐ Yes ☒ No Recovery Implications
☐ Yes ☒ No Security Impacts? i.e. supervisor state, key0-7, ECSA concerns
☒ Yes ☐ No All inspection concerns addressed?
☐ Yes ☒ No New parts to be shipped?
☐ Yes ☒ No Is an IPL required?
☒ Yes ☐ No QA: Test Strategy been added?
☒ Yes ☐ No Has a QA estimate duration time been added?
☐ Yes ☒ No ++JCLIN changes required?
☐ Yes ☐ No JCLIN reviewed/approved by all inspector?
☒ Yes ☐ No All control block references searched for possible impact?
V01 - 10/10/2018 ROCKET SOFTWARE INC, FOR INTERNAL USE ONLY Page 9
CAE SERVER, CAE AGENT CHECKLIST
V01 - 10/10/2018 ROCKET SOFTWARE INC, FOR INTERNAL USE ONLY Page 10
QA TEST STRATEGY
The QA test information should be placed in the QA Test strategy
section of the APAR Bug ticket.
Please include the following in the QA test strategy:
Overview
The report of a customer:
The load jobs of the CQM registers in DB2 for z/OS are
presenting a very large difference in run-time, with a difference
in the amount of records that does not justify this increase in
run-time.
The problem was:
1. Reading the SQLCD interval file to the end of the file
after each reading the record by key operation from the given
file.
2. For each reading the record by key operation for this file
the functions of opening and closing the data set were
performed.
Fixed a bug:
Changed the algorithm for reading record by key from the
SQLCD file.
V01 - 10/10/2018 ROCKET SOFTWARE INC, FOR INTERNAL USE ONLY Page 11
Close the interval.
V01 - 10/10/2018 ROCKET SOFTWARE INC, FOR INTERNAL USE ONLY Page 12
12.20.34 J0458763 CQM7014I RECORDS OFFLOADED FOR METRIC TEXT CLOB : INTV# ALL - 421107
12.20.34 J0458763 CQM7014I RECORDS OFFLOADED FOR EXCP TEXT CLOB : INTV# ALL - 1805
12.20.34 J0458763 CQM7014I RECORDS OFFLOADED FOR SQL TEXT CLOB : INTV# ALL - 21802
12.20.34 J0458763 CQM7014I RECORDS OFFLOADED FOR CQMERROR : INTV# ALL - 0
12.20.340458763 CQM7014I RECORDS READ FROM INTERVAL DATASETS: INTV# ALL - 5610956
V01 - 10/10/2018 ROCKET SOFTWARE INC, FOR INTERNAL USE ONLY Page 13
16.01.03 J0458900 CQM7014I RECORDS OFFLOADED FOR METRIC TEXT CLOB : INTV# ALL - 421107
16.01.03 J0458900 CQM7014I RECORDS OFFLOADED FOR EXCP TEXT CLOB : INTV# ALL - 1805
16.01.03 J0458900 CQM7014I RECORDS OFFLOADED FOR SQL TEXT CLOB : INTV# ALL - 21802
16.01.03 J0458900 CQM7014I RECORDS OFFLOADED FOR CQMERROR : INTV# ALL - 0
16.01.03 J0458900 CQM7014I RECORDS READ FROM INTERVAL DATASETS: INTV# ALL - 5610956
Regression Test
☐ Yes ☒ No Regression Test necessary
=> Compulsory for common parts used by multiple components
V01 - 10/10/2018 ROCKET SOFTWARE INC, FOR INTERNAL USE ONLY Page 15