create-jvm-options.1


sun.com \| docs.sun.com		How To Buy \| My Sun \| Worldwide Sites

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
OPERANDS
EXAMPLES
EXIT STATUS
SEE ALSO

NAME

create-jvm-options - creates the JVM options from the Java configuration or profiler elements

SYNOPSIS

create-jvm-options --user admin_user [ --password admin_password ][ --host localhost ] [ --port 4848 ] [ --secure|-s ] [ --passwordfile filename ] [ --terse=false ] [ --echo=false ] [ --interactive=true ] [ --profiler=false ](jvm_option_name=jvm_option_value)[:jvm_option_name=jvm_option_value]*

DESCRIPTION

Creates the JVM options in the Java configuration or Profiler elements of the domain.xml file. You can enter more than one JVM option separated by a colon (:) . If the JVM option starts with a dash (-) then use two dashes (--) before the operand to distinguish that JVM option is an operand and not an option. JVM options are used to record the settings needed to get a particular profiler going.

You must restart the server for the newly created JVM options to take affect. Use the start-domain command to restart the server domain.

OPTIONS

--user: authorized domain application server administrative username.
--password: password to administer the domain application server.
--host: machine name where the domain application server is running.
--port: port number of the domain application server listening for administration requests.
--secure: if true, uses SSL/TLS to communicate with the domain application server.
--passwordfile: file containing the domain application server password.
--terse: indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-formatted data for consumption by a script. Default is false.
--echo: setting to true will echo the command line statement on the standard output. Default is false.
--interactive: if set to true (default), only the required password options are prompted.
--profiler: indicates if the JVM options is for the profiler. Profiler must exist for this option to be true.

OPERANDS

jvm_option_name=jvm_option_value: the left side of the equal sign (=) is the JVM option name. The right side of the equal sign (=) is the jvm_option_value. Additionally, you can use ":" as a delimiter for more than one jvm-option. If the jvm-option contains a ":", use the escape character \ to offset the ":" delimiter.

EXAMPLES

Example 1. Using create-jvm-options

asadmin> create-jvm-options --user admin --password adminadmin 
--host localhost --port 4848 --profiler=false --DDebug=true:"-Xmx256m":"
-Dcom.sun.aas.imqBin"="\/export\/as7se\/imq\/bin"
Command create-jvm-options executed successfully

Where the JVM options are created. The double dash (--) is used between --profiler options and the operand because - indicated the end of the options and the following text is the operand. The double dash (--) is necessary here since there are single dashes (i.e., --DDebug) in the operand. To distinguish between the options and the operand, the double dash (--) is used.

EXIT STATUS

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