<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!ENTITY metainfo SYSTEM "metainfo.sgm">
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY Dash "&ndash;">
]>
<?Pub UDT _bookmark _target>
<?Pub EntList brvbar bull cross dash diam diams frac12 frac13 frac14 hellip
 laquo lArr loz mdash nabla ndash para pound rArr raquo sect yen bsol>
<?Pub Inc>
<refentry id="create-jvm-options-1">
<refmeta><refentrytitle>create-jvm-options</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="template">create-jvm-options &mdash;
creates the JVM options from the Java configuration or profiler elements</primary>
</indexterm><indexterm><primary sortas="template for documenting manpages for the Sun Java System Application Server">
creates the JVM options from the Java configuration or profiler elements &mdash;
create-jvm-options</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>&synp-tt;</title>
<cmdsynopsis><command>create-jvm-options</command>&synopsis-common;
<arg choice="opt">&Dash;&Dash;target <replaceable>target</replaceable></arg>
<arg choice="opt">&Dash;&Dash;profiler=false</arg><arg choice="plain">(<replaceable>
jvm_option_name=</replaceable><replaceable>jvm_option_value</replaceable>)
</arg><arg><replaceable>:jvm_option_name</replaceable>=<replaceable>jvm_option_name
</replaceable>*</arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</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><title>&opts-tt;</title>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="nodash">&Dash;&Dash;target</option></term>
<listitem><para>Specifies the target on which you are creating jvm options.
Valid targets are config, instance, cluster, or server. The default is server.
</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.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&oper-tt;</title>
<variablelist termlength="medium">
<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><title>&exam-tt;</title>
<example>
<title>Using the create-jvm-options command</title>
<para>JVM options must start with a dash (&Dash;). 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 4849 --target server
\\\\-Dunixlocation=/root/example:-Dvariable=
\\$HOME:-Dwindowslocation=d\\\\:\\\\\\sun\\\\\\appserver:-Doption1=-value1
</userinput>
Command create-jvm-options executed successfully</screen>
</example>
</refsect1>
<refsect1><title>&exit-tt;</title>
<variablelist termlength="medium">
<varlistentry><?Pub Caret><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><title>&also-tt;</title>
<para><link linkend="delete-jvm-options-1"><citerefentry><refentrytitle>delete-jvm-options
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000004577>
