IBM Support

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

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

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 number

    PJ46610

  • Reported component name

    Z/TPF

  • Reported component ID

    5748T1501

  • Reported release

    110

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2021-08-16

  • Closed date

    2021-09-08

  • Last modified date

    2021-09-08

  • 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

[{"Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSZL53","label":"TPF"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"110"}]

Document Information

Modified date:
09 September 2021