Open topic with navigation

Queued Commands

CLI commands that specify changes to the current configuration will either be committed to the configuration file as soon as they are entered, or queued to be committed using the commit, exit, or <ctrl-d> commands.

• If a complete command is executed for an object in a lower context, the command is committed to the configuration immediately. The current command context is not changed after the command is entered. A “complete” command is one that specifies all parameters required to add or modify the object.

For example, entering the following command to create a server creates the server immediately, and leaves eqcli in the global context:

• If an incomplete command is executed for an object in a lower context, the command is queued to be committed to the configuration until a commit, exit, or <ctrl-d> command is entered. The current command context changes to the context of the object argument of the incomplete command. An “incomplete" command is one does not include one or more parameters required to add or modify the object.

For example, if the server sv01 does not exist, entering the following server command in the global context queues the command and leaves eqcli in the relevant context; an explicit commit is needed to create the server:

• If a command is entered that affects only the object associated with the current context, the command is queued to be committed to the configuration until a commit, exit, or <ctrl-d> command is entered. The current command context does not change.

For example, if sv01 exists and the current context is “sv-sv01”, then the following commands are queued until a commit, exit, or <ctrl-d> command is entered:

Queued commands can be committed or discarded using the following commands:

• commit - Commits all queued commands; does not change the current context.
• exit <ctrl-d> - Commits all queued commands and changes to the next highest context in the hierarchy (if executed in the global context, either of these commands exits eqcli).
• discard -Discards all queued commands; does not change the current context.
• quit -Discards all queued commands and changes to the next highest context in the hierarchy (if executed in the global context, this command exits eqcli).

Note that the following commands always take effect immediately and do not change the current command context:

• A command that sets a global parameter (see Global Commands).
• The no form of a command (see Using the "no" Form of a Command.
• The show command in any context.

Related Topics