XG Series User's Guide Chapter 2 Using the CLI
Using the CLI
47
2.2.1.7 Configuration hierarchy function
The configuration hierarchy function interprets common portions of executed configuration command names and
arguments as a hierarchy level, and allows you to move between hierarchy levels.
When you execute a configuration command and the command completes successfully, in general the portion from the
command name to the argument two arguments before an argument specifying a variable value becomes a hierarchy level.
This may differ depending on the command.
Ex.)
Even in cases where an error occurs because the number of arguments is less than required, the configuration hierarchy
function assumes the entered command name and arguments to be a hierarchy level. Depending on the command, even if
arguments are incorrect the configuration hierarchy function may judge that there are not enough arguments and interpret
the entry as a hierarchy level. The portion assumed to be a hierarchy level is displayed at the command prompt. However,
if you have used a terminal prompt command to change the entry prompt string to exclude the configuration hierarchy, it is
not displayed.
After moving to a hierarchy level, you can only enter command arguments following the current level to execute the
command. When the number of arguments is still not enough, a further hierarchy level is displayed. When you have
omitted an optional argument, without moving to another hierarchy level the command is executed correctly, following
which you will move to a higher hierarchy level. Be sure to enter optional arguments as a group. To execute a command
other than at the hierarchy level you have moved to, enter it beginning with the command name.
However, in a hierarchy level for an argument which allows for arbitrary character strings, any strings other than the
commands below will be entered as configuration command arguments. To enter one of the following commands as an
argument for a configuration command, move to a higher level, and then enter so that strings matching these commands
are the second argument or following.
exit, !, end, quit, up, top, delete, show, clear, commit, discard, save, load, reset,
Comment line beginning with #
Ex.)
If you run the show command with no arguments after moving hierarchy levels, a list of configuration commands for that
level and following is displayed.
You can move to a higher hierarchy level or to the top level using an up command or top command respectively.
The configuration hierarchy function is disabled by default. Even when it has been enabled, this function is disabled after
you log out of the system. In this case, no message is displayed to indicate that the function has been disabled.
The following explains how to enable and disable the configuration hierarchy function.
• To enable the configuration hierarchy function: Press CTRL + O in configuration mode.
The following message is displayed and the configuration hierarchy function is enabled. Information which has been
partially entered will not be discarded.
(argument with variable value)
(configure)# lan 0 ip address 192.168.0.1/24 3
(Move hierarchy level to the argument two before the variable value argument)
(configure-lan-0-ip)#
(configure)# acl 0 ip (Moves to another level because there are not enough arguments.)
(configure-acl-0-ip)# any (Moves to another level because there are not enough arguments.)
(configure-acl-0-ip-any)# any (Moves to higher level because command can complete successfully
without specifying an optional argument.)
(configure-acl-0)#
<NOTICE> The configuration directory mode is enabled. To disable, type Ctrl+G.