PJ46610: With PJ44591, CPU utilization that is reported by CDC and real-time runtime metrics includes fenced I-streams.

APAR status

• Closed as program error.

Error description

• See Problem Summary.
  

Local fix

• NA
  

Problem summary

• APAR NUMBER:  PJ46610
  PRODUCT:  z/TPF
  FUNCTIONAL AREA:  CONTINUOUS DATA COLLECTION (CDC)
  SHIPPED IN YEAR:  2021
  
  ABSTRACT:
  With PJ44591, CPU utilization that is reported by CDC and
  real-time runtime metrics includes fenced I-streams.
  
  PACKAGE CONTENTS:
  Source Segments:
  (C) base/rt/cdcsym.asm
  
  Object Only Binaries:
  None.
  
  BINARIES TO BUILD: YES
  Configuration Independent Binaries:
  (C) base/lib/libcdcp_collect_lib.a
  (C) base/load/CDCP.so
  (C) base/load/CRRT.so
  (C) base/obj/cdcsym.o
  
  Configuration Dependent Binaries:
  None.
  
  COMMENTS:
  Under all circumstances, CPU utilization for Continuous Data
  Collection (CDC) and real-time runtime metrics collection is
  calculated as an average across all active I-streams on the
  LPAR. However, if there are I-streams above the I-stream cap
  (fenced I-streams), in most cases transactional work is not
  routed to these I-streams. In these cases, fenced I-streams
  should not be included in the CPU utilization calculation.
  

Problem conclusion

• SOLUTION:
  With this APAR applied, Continuous Data Collection (CDC) and
  real-time runtime metrics collection take the following into
  consideration when calculating CPU utilization:
  
  -Fenced I-streams exist. This happens when the I-stream cap is
  less than the total number of I-streams on the LPAR. All
  I-streams above the I-stream cap are fenced I-streams. In this
  case the CPU utilization (PRCSSR_UTL) metric is calculated
  based upon the number of in use I-streams. Fenced I-streams are
  ignored.
  
  -HiperDispatch is used. In this case it is possible that
  I-streams up to the I-stream cap are collapsed. As a result, a
  subset of the I-streams up to and including the I-stream cap
  are used to process transactional work. The CPU utilization
  (PRCSSR_UTL) metric is calculated based upon the I-stream cap.
  Utilization is based upon the number of I-streams that could be
  doing transactional work.
  
  -I-stream boost is used. In this case fenced I-streams are used
  to process transactional work for a period of time. When
  I-stream boost is active, all I-streams on the LPAR are used to
  process transactional work (in use I-streams) for 20 minutes
  following an IPL. After 20 minutes, in use I-streams above the
  I-stream cap are collapsed. One I-stream is collapsed every
  minute until the I-stream cap is reached. In this case the CPU
  utilization (PRCSSR_UTL) metric is calculated based upon the
  number of in use I-streams.
  
  COREQS: NO
  None.
  
  MIGRATION CONSIDERATIONS: NO
  None.
  
  BUILD COMMANDS AND INSTRUCTIONS: YES
  #maketpf commands for linux
  maketpf -f cdcp_collect_lib cdcsym.o
  maketpf cdcp_collect_lib link
  maketpf CRRT link
  maketpf CDCP link TPF_VERIFY_LINK_REFS=NO
  maketpf CDCP link
  
  UPDATED INFORMATION UNITS: NO
  None.
  
  See your IBM representative if you need additional information.
  
  DOWNLOAD INSTRUCTIONS:
  https://www.ibm.com/support/docview.wss?uid=swg27049604
  
  APAR URL:
  https://transfer.boulder.ibm.com/2021/PJ46610.tar.gz
  

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:

Fix information

• Fixed component name

  Z/TPF

• Fixed component ID

  5748T1501

Applicable component levels