Skip to main content

Techdocs Library > Presentations & Tools >

z/OS Data Extraction Program (CP3KEXTR) for zPCR and zBNA



Document Author:
Additional Author(s):

Valerie Spencer
Tom Harper


Document ID:

PRS4229


Doc. Organization:

Advanced Technical Sales


Document Revised:

04/24/2018


Product(s) covered:

z Systems







Abstract: The CP3KEXTR program reads SMF records and extracts data needed as input to IBM's Processor Capacity Reference (zPCR) and z Systems Batch Network Analyzer (zBNA) tools. CP3KEXTR is offered as a "No Charge" application.

Product Name:
CP3KEXTR
for
zBNA and zPCR
Product Version:
04/10/18 (v3.75)
Operating System:
z/OS
Change Date:
04/10/18
Approximate Size:
.12MB
Click on the icon to download package
Click on the icon to view User's Guide

Hide details for What's NewWhat's New
Version 04/10/18 (v3.75)
  1. Fix divide error when BCURDBR was 0
  2. Fix case where EFD vector would fail to include zero elements

Version 02/28/18 (v3.73)
  1. Add new vectors to report hardware group capping
  2. Fix 42(6) DATA file case where certain hyperlink fields were repeated
  3. Add new FCPI and PRBT vectors
  4. Detect case where type 70 CPU Data Section count is zero
  5. Add code to suppress EDF null SR parameter to space
  6. Add vector ABSMSUCP to indicate when absolute MSU capping is active

Version 12/04/17 (v3.62)
  1. Add new SMTEFFTDP vector for average thread density.
  2. Fixed case where counts were repeated in the SysId list.
  3. Make adjustments to the FICON Aggregation analysis.
  4. Adjusted the CPU MF L4LP formula.
  5. Refactored code in the cp2kExtr module.
  6. Added HyperLink and micro-second fields to DATA file.

Version 09/20/17 (v3.59)
  1. Blank DATA file ORDSENC field if encryption data is not present.
  2. Confirm presence of type 42(6) encryption fields.
  3. Remove message 273, EX72: R723CICT INVALID (WIORESPV) MSEC PER I/O > 1000.
  4. Delete unused vectors, LpwTZn, TI, TL, TT, TN,TX.
Version 08/09/17 (v3.55)
  1. Fix CF section case where key values were set to zero.
  2. Fix cache fields with invalid number of entries.
  3. Fix missing cache fields BCURDBR & BCUWRBR.
  4. Fix EDF Load failure due to incorrect EFC vector count.
  5. Fix SMF type 113 processing for z13 (message SMF113_2_CTRVN2 NOT = 1-5).
  6. Add 4 EDF “TLB Miss Rate” vectors based on type 113 counters.
  7. Update other CPU MF Formulas based on type 113 counters.
  8. Add 9 EDF vectors to CFE section with SMF 74.4 CF Encryption data.
  9. Add 8 DATA file fields with SMF 42.6 data for zBNA encryption analysis.
  10. Add 4 vectors to BCU section with SMF 74.5 Cache Control Unit data.
  11. Add a new EDF vector with updated SIIS percentage calculation.
  12. Fixed the BCUR and BCURV read percent calculations

Version 04/27/17 (v3.35)
  1. Switch five 42.6 DATA items to usec units.
  2. Rewrite the storage allocation routine.

Version 03/01/17 (v3.33)
  1. Change the z13 RNI factor from 2.6 to 2.3.
  2. Reassign 3 GetMain calls to the internal utility to fix a glitch for Phil & Jim.
  3. Change the EDF L1MP vector to 2 decimals and EFA & EFB to 3 decimals.
  4. Fix the save=sort=run processing to include type 14 & 15 records.
  5. Add a new vector PMAnn= containing SMF70PMA data.
  6. Add the SMF14NTU field to the DATA file.
  7. Fix the case where a large R744SSIZ value was getting truncated.
  8. Fix the case where a wrong SYSID was placed in the PGNMAP.

Version 10/26/16 (v3.26)
  1. Auto-generate zeros for missing vector entries.
  2. Remove use of 64-bit instruction to accommodate an older machine.
  3. Change WCDUR to be a weighted average.
  4. In the EDF FS section, fix the case where a CFLINKS value greater than 256 is truncated.

Version 08/08/16 (v3.20)
  1. To support FICON aggregation, add new PCHID item.
  2. Adjust vector SMF30CSU to use 8-byte SMF30CSU_L when available.
  3. New WORK vect R723CDUR - Period duration in weighted service units.

Version 02/16/16
Processor version code tables were updated to include the z13s.

Version 12/08/15
  1. New fields to the zBNA DATA001 output:
    -
    S42DSIOSE Flag to indicate that S42DSIOS field is present in the SMF record.
    -
    S42DSIOS the number of read/write operations to the Metro Mirror secondary
    -
    S42FICON flag if there are non-zero values in either S42DSHRD or S42DSHWR
    (indicates zHPF).
  2. New LPPCSnn vector for SMF70CSF Central Storage by LPAR.
  3. Small fix for unusual 113 data.

Version 10/27/15
  1. New DATA001 field, WAITINIT, for seconds waiting to start on initiator.
  2. New field, LPWLMDnn, is the number of samples where WLM did capping.
  3. Fix for field, LPWLMCnn, is the number of samples where WLM considered capping.
  4. Fix for BCUMAP; also updated so that non Disk control unit LCUs are not combined.

Version 10/05/15
Fix for the problem when with large LPAR configurations, zIIPs are occasionally misinterpreted to be dedicated; leading to negative utilizations.

Version 09/02/15
Fixed the problem when the input file contains SMF Type 113 records from multiple generations, i.e. z13 and z12 or z196.

Version 07/07/15
  1. Includes two additional SMT vectors, SMTEFFMP and SMTEFFMC.
    • These values are zero until SMT is active.
    • SMTEFFMC will not be available until general purpose processors include SMT; for now, it is a place holder.
  2. Fixed the ESS data issue with the SMF 74 subtype 8 records.
  3. Other miscellaneous fixes.

Version 05/22/15
1. Enhanced to avoid messages regarding missing 113 problem counters.
2. Corrected the problem when the groups in the group capacity table extended to a second line.
3. When there are invalid SMF Type 14 records, they will not be included in the .dat input file to zBNA.
4. Add support for two zIIP SMT fields, SMTEFFP and SMTEFFC.
    Notes:
    • These values are zero until SMT is active.
    • SMTEFFC will not be available until GCPs do SMT; for now, it is a place holder.

Version 02/26/15
  • Add support for z13 CPU MF data (113 data).
  • Small change to zEC12 113 calculation.

Version 01/14/15
  • The IBM z Systems (z13) processor family has been added, with 231 General Purpose models (90 slugged and 141 full-speed) and 141 IFL models. Various drawer configurations provide up to 141 real CPs, which can be configured as General Purpose, zIIP, IFL, or ICF engines. The processor designation is 2964-7xx for full speed models, and 2964-4xx, -5xx, or 6xx for slugged models.
  • LSPR data is now based on z/OS-2.1 (formerly z/OS-1.13).
  • Fix for SMF 113 processing.
  • Add new field, FPCM, to the CF section (R744FPCM).
Show details for CP3KEXTR Install Instructions:CP3KEXTR Install Instructions:
Show details for SupportSupport



Classification:

Hardware

Category:

Performance




Platform(s):

IBM System z Family



O/S:

MVS; OS/390; z/OS

Keywords:

IBM z Systems, CPS Tools, zBNA, zPCR, CP3KEXTR, RMF, SMF Records

The Techdocs Library
Is this your first visit to Techdocs (the Technical Sales Library)?

Learn more


Techdocs QuickSearch

: