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.
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.
[ Top of Page | Previous Page | Next Page | Contents | Index ]