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

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 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