<!--Arbortext, Inc., 1988-2007, v.4002-->
<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD SolBook 3.5//EN" [
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "common.ent">
%commonents;
]>
<?Pub UDT _bookmark _target>
<?Pub CX solbook(>
<refentry id="create-jvm-options-1"><?Pub Tag atict:info tracking="off" ref="2"><?Pub Tag
atict:user user="hl34125" fullname=""><?Pub Tag atict:user user="pmdavies"
fullname=""><?Pub Tag atict:user user="ah95648" fullname="">
<!-- @(#)create-jvm-options.1 1.10 07/07/11 SMI; -->
<refmeta><refentrytitle>create-jvm-options</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">11 Jul 2007</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&software;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">Copyright (c) 2007, Sun Microsystems, Inc.
All Rights Reserved</refmiscinfo>
</refmeta>
<refnamediv><indexterm><primary>create-jvm-options</primary></indexterm>
<indexterm><primary>creates the JVM options from the Java configuration or
profiler elements</primary></indexterm>
<refname>create-jvm-options</refname><refpurpose>creates JVM options in the
Java configuration or profiler element of the <filename>domain.xml</filename> file.
</refpurpose></refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>create-jvm-options</command> &synopsis-common; [<option
role="double-dash">target</option> <replaceable>target</replaceable>]
 [<option role="double-dash">profiler</option>={true|false}] (<replaceable>jvm_option_name
</replaceable>=<replaceable>jvm_option_value</replaceable>)
 [<replaceable>:jvm_option_name</replaceable>=<replaceable>jvm_option_name</replaceable>*]
</synopsis>
</refsynopsisdiv>
<refsect1 role="description"><title></title>
<para>The <command>create-jvm-options</command> command creates JVM options
in the Java configuration or profiler elements of the <filename>domain.xml</filename> file.
If JVM options are created for a profiler, they are used to record the settings
needed to get a particular profiler going.</para>
<para>This command is supported in remote mode only.</para>
<para>You must restart the server for newly created JVM options to take effect.
Use the <command>start/stop-domain</command> command to restart the domain
administration server.</para>
</refsect1>
<refsect1 role="options"><title></title>
<variablelist termlength="wholeline">&options-common;
<varlistentry><term><option role="double-dash">target</option></term>
<listitem><para>Specifies the target on which you are creating JVM options.
Valid targets are name of a configuration, instance, cluster. The default
is server, which is the name of the default server instance.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-profiler</option></term>
<listitem><para>Indicates whether the JVM options are for the profiler. The
profiler must exist for this option to be true. Default is false.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="operands"><title></title>
<variablelist termlength="wholeline">
<varlistentry><term><replaceable>jvm_option_name</replaceable></term>
<listitem><para>The left side of the equal sign (=) is the JVM option name.
The right side of the equal sign (=) is the JVM option value. A colon (:)
is a delimiter for multiple options.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="examples"><title></title>
<example><title>Using the create-jvm-options command</title>
<para>JVM options must start with a dash (&ndash;). Use the backslash (\\)
to escape the dash delimiter.</para>
<screen>asadmin> <userinput>create-jvm-options --interactive=true 
--secure=true --passwordfile passwords.txt --terse=false
 --user admin --host localhost --port 4848 --target<?Pub Caret> server
\\\\-Dunixlocation=/root/example:
-Dvariable=\\$HOME:-Dwindowslocation=d\\\\:\\\\\\sun\\\\\\appserver:
-Doption1=-value1</userinput>
Command create-jvm-options executed successfully</screen>
</example>
</refsect1>
<refsect1 role="exit-status"><title></title>
<variablelist termlength="medium">
<varlistentry><term>0</term>
<listitem><para>command executed successfully</para>
</listitem>
</varlistentry>
<varlistentry><term>1</term>
<listitem><para>error in executing the command</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="see-also"><title></title>
<para><olink targetdoc="asrefman" targetptr="delete-jvm-options-1">delete-jvm-options(1)
</olink></para>
</refsect1>
</refentry>
<?Pub *0000004374 0>
