IBM User Guide for Java V7 on Windows > Troubleshooting and support > Using diagnostic tools > Using dump agents > Advanced control of dump agents

opts option

The Heapdump agent uses this option to specify the type of file to produce.

Heapdumps and the opts option

You can specify a PHD Heapdump, a classic text Heapdump, or both. For example:

–Xdump:heap:opts=PHD (default)
–Xdump:heap:opts=CLASSIC
–Xdump:heap:opts=PHD+CLASSIC

For more information, see Enabling text formatted ("classic") Heapdumps.

Tool dumps and the opts option

The tool dump agent supports two options that can be specified using the opts option. You can run the external process asynchronously with opts=ASYNC. You can also specify a delay in milliseconds that produces a pause after starting the command. These two options can be used independently or together. The following examples show different options for starting a new process that runs myProgram:

-Xdump:tool:events=vmstop,exec=myProgram

Without the opts option, the tool dump agent starts the process, and waits for the process to end before continuing.

-Xdump:tool:events=vmstop,exec=myProgram,opts=ASYNC

When opts=ASYNC is specified, the tool dump agent starts the process, and continues without waiting for the new process to end.

-Xdump:tool:events=vmstop,exec=myProgram,opts=WAIT1000

This option starts the process, waits for the process to end, and then waits a further 1 second (1000 milliseconds) before continuing.

-Xdump:tool:events=vmstop,exec=myProgram,opts=ASYNC+WAIT10000

Finally the last example starts the process and waits for 10 seconds before continuing, whether the process is still running or not. This last form is useful if you are starting a process that does not end, but requires time to initialize properly.

For more information about using the dump agent tool option, see Tool option.

Parent: Advanced control of dump agents

Error 404 - Not Found

The document you are looking for may have been removed or re-named. Please contact the web site owner for further assistance.