IBM Support

PJ45580: Java Agent for IBM Monitoring and Diagnostic Tools - Health Center on z/TPF

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

Problem conclusion

  • 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
    

Temporary fix

Comments

APAR Information

  • APAR number

    PJ45580

  • 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

    2018-11-14

  • Closed date

    2019-03-15

  • Last modified date

    2019-03-15

  • 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



Document information

More support for: TPF
z/TPF

Software version: 110

Reference #: PJ45580

Modified date: 15 March 2019