IBM Support

PJ46312: z/TPF system monitoring for Java applications.

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:  PJ46312
    PRODUCT:  z/TPF
    FUNCTIONAL AREA:  Java
    SHIPPED IN YEAR:  2021
    
    ABSTRACT:
    z/TPF system monitoring for Java applications.
    
    PACKAGE CONTENTS:
    Source Segments:
    (C) base/a2e/headers/ctype.h
    (C) base/cntl/tpf.cntl
    (C) base/cntl/tpf.loadfile
    (N) base/cntl/tpfjmon.cntl
    (N) base/cntl/tpfjmon.loadfile
    (C) base/rt/dj01.c
    (N) base/rt/dj05.mak
    (N) base/rt/rtmjni.cpp
    (N) base/tpfjmon/DJ05
    (N) base/tpfjmon/pom.xml
    (N) base/tpfjmon/src/com/ibm/tpf/agent/GCCustomEvent.java
    (N) base/tpfjmon/src/com/ibm/tpf/agent/JMXEvent.java
    (N) base/tpfjmon/src/com/ibm/tpf/agent/JMXTask.java
    (N) base/tpfjmon/src/com/ibm/tpf/agent/MbeanConfig.java
    (N) base/tpfjmon/src/com/ibm/tpf/agent/MbeanConfigException.java
    (N) base/tpfjmon/src/com/ibm/tpf/agent/RelationalData.java
    (N) base/tpfjmon/src/com/ibm/tpf/agent/TpfAgentRuntime.java
    (N) base/tpfjmon/src/com/ibm/tpf/TPFAgent.java
    (N) base/tpfjmon/tpfjmon.mak
    (N) tpftools/include_ztpf/maketpf.env_tpfjmon
    (C) tpftools/include_ztpf/maketpf.rules_maven
    (C) tpftools/maven/dependencies.txt
    
    Object Only Binaries:
    (C) base/oco/lib/libDJAI.so
    (C) base/oco/lib/libDJHC.so
    (C) base/oco/lib/libDJHM.so
    (C) base/oco/load/DJAI.so
    (C) base/oco/load/DJHC.so
    (C) base/oco/load/DJHM.so
    
    BINARIES TO BUILD: YES
    Configuration Independent Binaries:
    (N) base/lib/libDJ05.so
    (C) base/load/DJ01.so
    (N) base/load/DJ05.so
    (C) base/obj/DJ01/dj01.o
    (N) base/obj/rtmjni.o
    
    Configuration Dependent Binaries:
    (N) base/gen/tpfjmon/tpfagent.jar
    (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 for Java applications provides a
    system-wide view of all JVMs that are running on a z/TPF
    system. This APAR provides the infrastructure for monitoring
    Java applications.
    

Problem conclusion

  • SOLUTION:
    For z/TPF system monitoring for Java applications, JVM data is
    collected with a z/TPF agent. That data is passed along to
    z/TPF real-time runtime metrics collection, which sends the
    data to Apache Kafka for further analysis (see PJ47275 for more
    information).
    
    The z/TPF agent can collect data for Java applications whether
    or not they are running in a z/TPF application manager for Java
    (JAM). The z/TPF agent collects the following types of data:
    - Health Center data
    - Select Java Management Extensions (JMX) data:
     - Kafka producer metrics (for applications running in a JAM)
     - CXF performance metrics
     - Custom MBean data (for applications instrumented with MBeans
    and MXBeans)
    
    Before applying this APAR, ensure that:
    - APAR PJ46432, including the 1Q2021 Java refresh package, is
    installed.
    - APAR PJ46275 is installed to allow the collected data to flow
    to Apache Kafka.
    
    COREQS: NO
    None.
    
    MIGRATION CONSIDERATIONS: YES
    Coexistence, migration, and fallback considerations:
    Prior to installing this APAR, the following APARs must be
    installed in this order:
    1) PJ46362
    2) PJ46390
    3) PJ46432
    4) PJ46275
    
    
    
    BUILD COMMANDS AND INSTRUCTIONS: YES
    #maketpf commands for linux
    maketpf -f DJ01 dj01.o
    maketpf -f DJ05 rtmjni.o
    maketpf -f TPFSTUB link
    maketpf -f IPAT
    maketpf DJ01 link TPF_VERIFY_LINK_REFS=NO
    maketpf tpfagent link
    maketpf DJ05 link
    maketpf DJ01 link
    
    UPDATED INFORMATION UNITS: YES
    z/TPF and z/TPFDF Migration Guide: PUT 2 and Later
    z/TPF Support for Java
    
    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/PJ46312.tar.gz
    

Temporary fix

Comments

APAR Information

  • APAR number

    PJ46312

  • 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-09-29

  • Closed date

    2021-04-14

  • Last modified date

    2021-04-14

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Publications Referenced
SK2T8062    

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:
15 April 2021