docs/reference-manual/src/main/asciidoc/list-jvm-options.adoc

type=page
status=published
title=list-jvm-options
next=list-libraries.html
prev=list-jobs.html
~~~~~~

= list-jvm-options

[[list-jvm-options-1]][[GSRFM00180]][[list-jvm-options]]

== list-jvm-options

Lists options for the Java application launcher

[[sthref1608]]

=== Synopsis

[source]
----
asadmin [asadmin-options] list-jvm-options [--help]
[--target target]
[--profiler={false|true}]
----

[[sthref1609]]

=== Description

The `list-jvm-options` subcommand displays a list of command-line
options that are passed to the Java application launcher when
{productName} is started.

The options are managed by using the JVM Options page of the
Administration Console or by using the `create-jvm-options` and
`delete-jvm-options` subcommands.

This subcommand is supported in remote mode only.

[[sthref1610]]

=== Options

asadmin-options::
  Options for the `asadmin` utility. For information about these
  options, see the link:asadmin.html#asadmin-1m[`asadmin`(1M)] help page.
`--help`::
`-?`::
  Displays the help text for the subcommand.
`--target`::
  Specifies the target for which you are listing Java application
  launcher options. Valid values are as follows:

  `server`;;
    Specifies the DAS (default).
  instance-name;;
    Specifies a {productName} instance.
  cluster-name;;
    Specifies a cluster.
  configuration-name;;
    Specifies a named configuration.

`--profiler`::
  Specifies whether the Java application launcher options to list are
  for the profiler. Set this option to true only if a profiler has been
  configured. If this option is set to true and no profiler is
  configured, an error occurs. The default is false.

[[sthref1611]]

=== Examples

[[GSRFM679]][[sthref1612]]

==== Example 1   Listing the Java Application Launcher Options

This example lists the options that are used by the Java application launcher.

[source]
----
asadmin> list-jvm-options
-Djava.security.auth.login.config=${com.sun.aas.instanceRoot}/config/login.conf
-XX: LogVMOutput
-XX: UnlockDiagnosticVMOptions
-Dcom.sun.enterprise.config.config_environment_factory_class=
com.sun.enterprise.config.serverbeans.AppserverConfigEnvironmentFactory
-Djavax.net.ssl.keyStore=${com.sun.aas.instanceRoot}/config/keystore.jks
-XX:NewRatio=2
-DANTLR_USE_DIRECT_CLASS_LOADING=true
-Djava.security.policy=${com.sun.aas.instanceRoot}/config/server.policy
-Djdbc.drivers=org.apache.derby.jdbc.ClientDriver
-Djavax.net.ssl.trustStore=${com.sun.aas.instanceRoot}/config/cacerts.jks
-client
-Djava.ext.dirs=${com.sun.aas.javaRoot}/lib/ext${path.separator}${
com.sun.aas.javaRoot}/jre/lib/ext${path.separator}${com.sun.aas.instanceRoot}
/lib/ext${path.separator}${com.sun.aas.derbyRoot}/lib
-Xmx512m
-XX:MaxPermSize=192m
-XX:LogFile=${com.sun.aas.instanceRoot}/logs/jvm.log
Command list-jvm-options executed successfully.
----

[[sthref1613]]

=== Exit Status

0::
  subcommand executed successfully
1::
  error in executing the subcommand

[[sthref1614]]

=== See Also

link:asadmin.html#asadmin-1m[`asadmin`(1M)]

link:create-jvm-options.html#create-jvm-options-1[`create-jvm-options`(1)],
link:delete-jvm-options.html#delete-jvm-options-1[`delete-jvm-options`(1)]

For more information about the Java application launcher, see the
reference page for the operating system that you are using:

* Oracle Solaris and Linux: java - the Java application launcher
(``http://docs.oracle.com/javase/6/docs/technotes/tools/solaris/java.html)
* Windows: java - the Java application launcher
(``http://docs.oracle.com/javase/6/docs/technotes/tools/windows/java.html)