Skip to content

-Dcom.ibm.tools.attach.enable

Enable the Attach API for this application.

Syntax

    -Dcom.ibm.tools.attach.enable=[yes|no]

On AIX®, Linux®, macOS®, and Windows™ systems, the following default applies:

Value Effect Default
yes Enable yes
no Disable

On z/OS® systems, the following default applies:

Value Effect Default
yes Enable
no Disable yes

Explanation

A useful reference for information about the Java™ Attach API can be found at http://docs.oracle.com/javase/8/docs/technotes/guides/attach/index.html. The following extract is taken from the Oracle documentation:

The Attach API is an extension that provides a mechanism to attach to a Java virtual machine. A tool written in the Java Language, uses this API to attach to a target virtual machine and load its tool agent into that virtual machine.

A usage example is to late attach the IBM® Health Center agent to a virtual machine (VM) that is already running.

The Eclipse OpenJ9™ implementation of the Attach API is equivalent to the Oracle implementation. However, the OpenJ9 implementation cannot be used to attach to, or accept attach requests from, other VM implementations.

See also