<!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 Inc>
<refentry id="multimode-1">
<refmeta><refentrytitle>multimode</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="multimode">multimode &mdash; allows
you to execute multiple commands while preserving environment settings and
remaining in the asadmin utility</primary></indexterm><indexterm><primary
sortas="allows you to execute multiple commands while preserving environment settings and remaining in the asadmin utility">
allows you to execute multiple commands while preserving environment settings
and remaining in the asadmin utility &mdash; multimode</primary></indexterm>
<refname>multimode</refname><refpurpose>allows you to execute multiple commands
while preserving environment settings and remaining in the asadmin utility
</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>multimode <optional><option>-file</option> <replaceable>
filename</replaceable></optional> <optional><option>-printprompt=true</option></optional> <optional><option>
-encoding</option> <replaceable>encode</replaceable></optional> <optional><option>
-terse=false</option></optional> <optional><option>-echo=false</option></optional> 
</command>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>Use <command>multimode</command> to process the asadmin commands. The
command-line interface will prompt you for a command, execute that command,
display the results of the command, and then prompt you for the next command.
Additionally, all the asadmin option names set in this mode are used for all
the subsequent commands. You can set your environment and run commands until
you exit <command>multimode</command> by typing &ldquo;exit&rdquo; or &ldquo;quit.&rdquo;
You can also provide commands by passing a previously prepared list of commands
from a file or standard input (pipe). You can invoke <command>multimode</command>
from within a <emphasis>multimode</emphasis> session; once you exit the second <emphasis>
multimode</emphasis> environment, you return to your original <emphasis>multimode
</emphasis> environment.</para>
<para>This command is supported in local mode only.</para>
</refsect1>
<refsect1><title>&opts-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><option>-file</option></term><listitem><para>reads the
commands as defined in the file.</para>
</listitem></varlistentry>
<varlistentry><term><option>-printprompt</option></term><listitem><para>allows
the printing of asadmin prompt after each command is executed. Set this option
to false when the commands are piped or redirected from the standard input
or file. By default the option is set to true.</para>
</listitem></varlistentry>
<varlistentry><term><option>-encoding</option></term><listitem><para>specifies
the locale for the file to be decoded.</para>
</listitem></varlistentry>
<varlistentry><term><option>-terse</option></term><listitem><para>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.</para>
</listitem></varlistentry>
<varlistentry><term><option>-echo</option></term><listitem><para>setting to
true will echo the command line statement on to the standard output. Default
is false.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using <command>multimode</command> to execute multiple commands</title>
<screen>% <userinput>asadmin multimode --file commands_file.txt</userinput></screen>
<para>Where: <command>%</command> is the system prompt. The administrative
commands are executed from the <filename>commands_file.txt</filename> file.
</para>
</example>
</refsect1>
<refsect1><title>&exit-tt;</title>
<variablelist termlength="medium"><?Pub Caret>
<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><title>&also-tt;</title>
<para><link linkend="export-1"><citerefentry><refentrytitle>export</refentrytitle>
<manvolnum>1</manvolnum></citerefentry></link>, <link linkend="unset-1"><citerefentry>
<refentrytitle>unset</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000004908>
