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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSZL53","label":"TPF"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"110"}]
Document Information
Modified date:
14 April 2021