IBM Support

PJ46275: Real-time runtime metrics collection system-wide JVM monitoring support.

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 new function.

Error description

  • See Problem Summary.
    

Local fix

  • NA
    

Problem summary

  • APAR NUMBER:  PJ46275
    PRODUCT:  z/TPF
    FUNCTIONAL AREA:  NAME VALUE PAIR COLLECTION
    SHIPPED IN YEAR:  2021
    
    ABSTRACT:
    Real-time runtime metrics collection system-wide JVM monitoring
    support.
    
    PACKAGE CONTENTS:
    Source Segments:
    (C) base/cntl/tpf.loadfile
    (C) base/cntl/tpf_app_base.cntl
    (C) base/cp/cmis.cpy
    (C) base/cp/ct41.cpy
    (N) base/include/tpf/crrn.hpp
    (C) base/include/tpf/crrs_send.hpp
    (C) base/include/tpf/irtmc.hpp
    (C) base/macro/irtmc.mac
    (C) base/rt/crri.mak
    (N) base/rt/crrn.mak
    (N) base/rt/crrn_send_preformatted_data.cpp
    (C) base/rt/crrs.mak
    (C) base/rt/crrs_send.cpp
    (C) base/rt/crrt.cpp
    (C) base/rt/crrw.cpp
    (N) base/rt/rtmc_utils.cpp
    (C) base/rt/rt_rtmc_display.cpp
    (C) base/rt/rt_rtmc_modify.cpp
    (C) base/rt/rt_rtmc_start.cpp
    (C) base/rt/rt_rtmc_stop.cpp
    (C) base/rt/zrtmc.cpp
    (N) base/tpf-fdes/rtmc_preformatted_data_header.gen.dfdl.xsd
    (C) base/tpfrtmc/bin/tpfrtmc.war
    
    Object Only Binaries:
    None.
    
    BINARIES TO BUILD: YES
    Configuration Independent Binaries:
    (C) base/lib/libCRRI.so
    (N) base/lib/libCRRN.so
    (C) base/lib/libCRRS.so
    (C) base/load/CRRC.so
    (C) base/load/CRRI.so
    (N) base/load/CRRN.so
    (C) base/load/CRRS.so
    (C) base/load/CRRT.so
    (C) base/load/CRRW.so
    (N) base/obj/crrn_send_preformatted_data.o
    (C) base/obj/crrs_send.o
    (C) base/obj/crrt.o
    (C) base/obj/crrw.o
    (N) base/obj/rtmc_utils.o
    (C) base/obj/rt_rtmc_display.o
    (C) base/obj/rt_rtmc_modify.o
    (C) base/obj/rt_rtmc_start.o
    (C) base/obj/rt_rtmc_stop.o
    (C) base/obj/zrtmc.o
    
    Configuration Dependent Binaries:
    (C) <sys>/load/CPS0.so
    (C) <sys>/obj/ccctin.o
    (C) <sys>/obj/ccnucl.o
    (C) <sys>/load/IPAT.so
    (C) <sys>/stdlib/libTPFSTUB.so
    (C) <sys>/stdload/TPFSTUB.so
    (C) <sys>/obj/ipat.o
    
    COMMENTS:
    z/TPF system monitoring provides the capability to collect
    system-wide Java virtual machine (JVM) data about Java
    applications that are running on a z/TPF system (see PJ46312
    for details). Real-time runtime metrics collection is enhanced
    to provide infrastructure for z/TPF system monitoring for Java
    applications.
    

Problem conclusion

  • SOLUTION:
    Real-time runtime metrics collection captures the collected JVM
    data and sends them to Apache Kafka for further analysis. The
    tpfrtmc offline utility formats the system-wide JVM data so
    that monitors, databases, and analysis can easily and flexibly
    consume the data.
    
    The ZRTMC Modify command allows the user to specify an endpoint
    group descriptor for JVM connections. This endpoint group
    descriptor must be unique. The user cannot reuse the endpoint
    groups for CDC and name-value pair collection. But the
    descriptor can point to the same CDC/name-value pair collection
    tpfrtmc instance. If NONE is specified, no JVM data will flow
    to the tpfrtmc offline utility. If the JVM endpoint descriptor
    is not valid, all ZRTMC functionality is shut down in error.
    
    ZRTMC settings are saved across an IPL. However, if the z/TPF
    system is restarted when real-time runtime metrics collection
    processing is running, real-time runtime metrics collection
    processing stops.
    
    The z/TPF real-time insights dashboard starter kit is enhanced
    to consume the system-wide JVM data and provide a series of
    sample dashboards for you to monitor, diagnose, and analyze the
    data in real time. The z/TPF real-time insights dashboard
    starter kit can be downloaded here:
    https://www.ibm.com/support/pages/ztpf-real-time-insights-dashbo
    ard-starter-kit.
    
    
    The following problems are addressed by this APAR:
    1) crrw.cpp is updated to restore protection key after calling
    RTMC shutdown routine when an endpoint group is not valid.
    
    2) The ZRTMC processing has been changed to leverage the
    PJ46362 sub second cretc support to limit wandering data
    intervals when the system is under load or VM.
    
    COREQS: YES
    PJ46362
    
    MIGRATION CONSIDERATIONS: YES
    Functional, automation, and operation changes:
    Changed command:
    ZRTMC
    New messages:
    RTMC2033E
    RTMC2034E
    RTMC2035I
    RTMC9220E
    RTMC9221E
    RTMC9222E
    RTMC9223E
    RTMC9224E
    RTMC9281E
    RTMC9361E
    RTMC4500E
    RTMC4501E
    RTMC4502I
    RTMC4503E
    RTMC4504E
    RTMC4505E
    RTMC4506E
    RTMC4507E
    RTMC4508E
    
    Obsoleted messages:
    RTMC2024E
    RTMC2028E
    RTMC2029E
    RTMC2030E
    RTMC2031E
    RTMC9201E
    RTMC9202E
    RTMC9209E
    RTMC9250I
    RTMC9273E
    RTMC9279E
    
    Changed messages:
    RTMC0401E
    RTMC2023E
    RTMC2027E
    RTMC9250I
    RTMC9330I
    
    Hardware, software, and configuration changes:
    The tpfrtmc offline utility property file will need to be
    updated to accept this new apar. Even if jvm data is not being
    used during realtime processing, the segment in the property
    file is required as is cdc, and nvpc.
    
    Database changes:
    # Initialize the real-time runtime metrics collection control
    record on all processors:
    ZIFIL IBMMP4/FCCE/00/98/98/NNN/N
    
    
    
    BUILD COMMANDS AND INSTRUCTIONS: YES
    #maketpf commands for linux
    maketpf -f CPS0 ccctin.o ccnucl.o
    maketpf -f CRRS crrs_send.o
    maketpf -f CRRI rtmc_utils.o rt_rtmc_display.o rt_rtmc_modify.o
    rt_rtmc_start.o rt_rtmc_stop.o
    maketpf -f CRRT crrt.o
    maketpf -f CRRW crrw.o
    maketpf -f CRRC zrtmc.o
    maketpf -f CRRN crrn_send_preformatted_data.o
    maketpf -f TPFSTUB link
    maketpf CPS0 link
    maketpf -f IPAT
    maketpf CRRS link
    maketpf CRRI link
    maketpf CRRT link
    maketpf CRRW link
    maketpf CRRC link
    maketpf CRRN link
    
    UPDATED INFORMATION UNITS: YES
    z/TPF and z/TPFDF Migration Guide: PUT 2 and Later
    z/TPF Messages (Online, SQLCODEs, and errno Values)
    z/TPF Messages (System Error, Offline, and Program Status Word)
    z/TPF Operations
    z/TPF System Performance and Measurement Reference
    
    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/PJ46275.tar.gz
    

Temporary fix

Comments

APAR Information

  • APAR number

    PJ46275

  • 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

    2020-08-25

  • Closed date

    2021-04-13

  • Last modified date

    2021-04-13

  • 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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSZL53","label":"TPF"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"110"}]

Document Information

Modified date:
14 April 2021