multimode
Allows multiple subcommands to be run while preserving environment settings and remaining in the asadmin utility.
Synopsis
asadmin [asadmin-options] multimode [--help]
[--file filename]
[--printprompt={true|false}] [--encoding encode]Description
The multimode subcommand processes asadmin subcommands sequentially in a single session. The command-line interface prompts for a subcommand, runs that subcommand, displays the results of that subcommand, and then prompts for the next subcommand. All the asadmin options set in multimode apply to subsequent commands until the multimode session is exited. You exit multimode by typing exit, quit, or Ctrl-D.
You can use the export subcommand to set your environment, or use the`unset` subcommand to remove environment variables from the multimode environment.
You can also provide subcommands by passing a previously prepared list of subcommands from a file or standard input (pipe). When you use a file, you can include comment lines in the file by entering the hash symbol (#) as the first character of the line.
You can invoke multimode from within a multimode session. When you exit the second multimode environment, you return to your original multimode environment.
All the remote asadmin utility options can be supplied when invoking the multimode subcommand. The settings will apply as defaults for all subcommands that are run within the multimode session. For a list of the asadmin utility options, see the asadmin help page.
Options
- asadmin-options
-
Options for the
asadminutility. For information about these options, see theasadminhelp page. --help-?-
Displays the help text for the subcommand.
--file-f-
Reads the subcommands in the specified file.
--printprompt-
Controls printing of the
asadminprompt. By default, this option is set to the same value as the--interactiveasadminutility option. Normally you will not need to specify this option. Default is true. --encoding-
Specifies the character set for the file to be decoded. By default, the system character set is used.
Examples
Example 1 Starting a Multimode Session
This example starts a multimode session where: % is the system prompt.
% asadmin multimode
asadmin>You can also start a multimode session by typing asadmin without options or subcommands at the system prompt.
Example 2 Running Multiple Commands From a File
This example runs a sequence of subcommands from the commands_file.txt file.
% asadmin multimode --file commands_file.txt