PJ45580: Java Agent for IBM Monitoring and Diagnostic Tools - Health Center on z/TPF
Closed as new function.
See Problem Summary.
APAR NUMBER: PJ45580 PRODUCT: z/TPF FUNCTIONAL AREA: Java SHIPPED IN YEAR: 2019 ABSTRACT: Java Agent for IBM Monitoring and Diagnostic Tools - Health Center on z/TPF PACKAGE CONTENTS: Source Segments: (C) base/a2e/atoe.c (C) base/a2e/atoe_utils.c (C) base/a2e/headers/arpa/inet.h (C) base/cntl/tpf_rt4j.cntl (C) base/cntl/tpf_rt4j.loadfile (C) base/exp/CTIS.exp (C) base/include/sys/resource.h (N) base/rt/cgetrusa.c (C) base/rt/cgettime.c (C) base/rt/ctis.mak (C) base/tpfjax/src/com/ibm/tpf/TPFSecurityManager.java (N) tpftools/include_ztpf/maketpf.env_hc Object Only Binaries: (N) base/oco/lib/libDJAI.so (N) base/oco/lib/libDJHC.so (N) base/oco/lib/libDJHM.so (N) base/oco/load/DJAI.so (N) base/oco/load/DJHC.so (N) base/oco/load/DJHM.so Configuration Independent Binaries: (C) base/lib/libCTOE.so (C) base/load/CTOE.so (C) base/obj/atoe.o (C) base/obj/atoe_utils.o (N) base/obj/cgetrusa.o (C) base/obj/cgettime.o (C) base/stdlib/libCTIS.so (C) base/stdload/CTIS.so Support Files: base/lst/atoe.lst base/lst/atoe_utils.lst base/lst/cgetrusa.lst base/lst/cgettime.lst base/lst/CTIS.map base/lst/CTOE.map OTHER BINARIES TO BUILD: YES (O) base/gen/tpfjax/lib/tpfjax.jar (C) base/gen/tpfjax/tpfjax.jar (C) <sys>/load/IPAT.so (C) <sys>/obj/ipat.o COMMENTS: This enhancement to the z/TPF Java support (PJ43892) provides a Java agent for the IBM Monitoring and Diagnostic Tools - Health Center tool for use with JVMs running on z/TPF. IBM Monitoring and Diagnostic Tools - Health Center is a diagnostic tool for monitoring the status of a running Java application. The Heath Center agent uses a small amount of processor time and memory, and can open some log and trace files for analysis. This enhancement only includes the Java Agent, a standalone Eclipse plugin is required to monitor the data. This can be obtained from the Eclipse Marketplace or as part of the IBM Support Assistant.
SOLUTION: You can invoke the agent using the -Xhealthcenter java command line option, or start the agent using the "ZFILE java -jar /sys/tpf_pbfiles/opt/ibm/java-s390x-80/jre/lib/ext/healthcenter. jar" command. The healthcenter.jar will list java processes that can be attached. You can then reenter the command, specifying the ID= parameter to identify the process you wish to monitor. Java command line options for a JVM running in a JAM should be added to the "OtherCommandLineOptions" section of the jam.xml configuration file. Updates are provided to the TPF security manager to enable the Java agent. This change also allows a customer to specify a regular expression in the tpf.clpolicy file by prefixing the regular expression with a "/" character. COREQS: NO None. MIGRATION CONSIDERATIONS: YES Build and load process changes: "loadtpf <path>base/cntl/tpf_rt4j.loadfile -m PJ45580" to ensure libhealthcenter.so is loaded to your system "loadtpf <path>/base/cntl/tpfjax.loadfile -m tpfsec" to reload the updates to the security manager are loaded to your system BUILD COMMANDS AND INSTRUCTIONS: YES #maketpf commands for linux maketpf -f CTIS cgetrusa.o cgettime.o maketpf -f CTOE atoe.o atoe_utils.o maketpf tpfjax link maketpf CTIS link TPF_VERIFY_LINK_REFS=NO maketpf -f IPAT maketpf CTOE link maketpf CTIS link UPDATED INFORMATION UNITS: YES z/TPF and z/TPFDF Migration Guide: PUT 2 and Later 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/2019/PJ45580.tar.gz
Reported component name
Reported component ID
NoSpecatt / Xsystem
Last modified date
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Fixed component name
Fixed component ID