Application Performance Analyzer for z/OS, Version 11.1, Customization Guide

Enable Java late attach API

Successful sampling of Java V5 and Java V6 applications in Application Performance Analyzer requires the Java late attach API be installed on your system and enabled in the application being sampled. The Java late attach API is enabled by adding, the '-Dcom.ibm.tools.attach.enable=yes' run time parameter to the application being sampled. An example of a how to enable the Java late attach API in JCL that executes BPXBATCH to run the Java program ‘myprog' follows:

//STEP EXEC PGM=BPXBATCH,
//  PARM='sh java -Dcom.ibm.tools.attach.enable=yes myprog'

Depending on the Java service release level you are running, the application being sampled may need to be run with UID=0 (the same UID as Application Performance Analyzer itself). See the chart below for the specific Java PTFs and service release levels that include the late attach API, and for the associated job requirements for sampling.

Table 4. Java PTFs Including the Late Attach API
Java Version Service Release Java PTF Job Requirements
V5 31-bit SR10 UK48410 Add Dcom.ibm.tools.attach.enable=yes to the application being sampled. Run the application being sampled with UID=0.
V5 31-bit SR11 UK51963 Add Dcom.ibm.tools.attach.enable=yes to the application being sampled. Run the application being sampled with UID=0.
V5 31-bit SR12 and above UK59131 Add Dcom.ibm.tools.attach.enable=yes to the application being sampled.
V5 64-bit SR12 and above UK59134 Add Dcom.ibm.tools.attach.enable=yes to the application being sampled.
V6 31-bit SR6 UK50947 Add Dcom.ibm.tools.attach.enable=yes to the application being sampled. Run the application being sampled with UID=0.
V6 31-bit SR7 UK53084 Add Dcom.ibm.tools.attach.enable=yes' to the application being sampled. Run the application being sampled with UID=0.
V6 31-bit SR8 and above UK56434 Add Dcom.ibm.tools.attach.enable=yes to the application being sampled.
V6 64-bit SR8 and above UK56435 Add Dcom.ibm.tools.attach.enable=yes to the application being sampled.

When measuring applications running with ‘-Dcom.ibm.tools.attach.enable=yes' and without ‘UID=0', J9VM might write some OPEN access violations in the system log. These can be ignored, because J9VM is attempting to open tmp directories that require UID=0 access. These directories have no significance to Application Performance Analyzer Analyzer and will not affect the measurement.




Rate this page

[ Top of Page | Previous Page | Next Page | Contents | Index ]