rmvs command

Use the rmvs command to permanently delete one or more virtual servers and, optionally, any attached storage.

Synopsis

smcli [-c] [-prompt] [-user user_name] [-pw password] rmvs options
  • For information about the options listed above that are specific to smcli, enter smcli -?.

smcli rmvs [-h | -? | --help]

smcli rmvs [-v] -n name_list [-s]

Description

The rmvs command permanently deletes one or more specified virtual servers. You can also specify to remove any storage that is attached to those virtual servers.

Operands

The rmvs command takes a list of host names or OIDs as operands.

Options

-h | -?
Displays the syntax and a brief description of the command.
Tip: If you specify additional options, the options are ignored.
--help
Displays detailed information about the command, including the syntax, a description of the command, a description of the options and operands, error codes, and examples.
Tips:
  • If you specify additional options, the options are ignored.
  • (AIX® and Linux only) You can also display detailed help in the form of man pages using the man command_name command.
-n | --names {"system_name" | system_oid}[,...]
Specifies a comma-separated list of the names or OIDs of the virtual servers on which you will take action. The list can mix system names and system OIDs.
system_name
Specifies the name of the system.
Tips:
  • To list all system names, use the lssys command without any options.
  • If a system name contains special characters such as spaces, enclose the name in quotation marks.
  • If a system name contains a comma, prefix the comma with a backslash (\).
  • The system names might not be unique. This command acts on all systems with the specified name. Use the -v | --verbose option to generate a message when this command targets multiple systems with the same name. To target a particular system that has a name that is not unique, identify the system by specifying its unique, hexadecimal ID, or use additional target options to refine the selection.
  • The system names are not locale specific.
system_oid
Specifies the unique ID of the system as a hexadecimal value prefixed with 0x (for example, 0x37).
Tip: To list all system OIDs, use the lssys command with the -o option.
-s | --storage
When set, specifies to remove attached storage along with the virtual server.
-v | --verbose
Writes verbose messages to standard output.

If this option is not specified, this command suppresses noncritical messages.

Exit status

The following codes are returned by this command.
  • 0: The operation completed.
  • 1: A usage error occurred.
  • 2: The command or bundle was not found.
  • 3: The command was not performed because either authentication failed or you are not authorized to perform the action.
  • 29: The specified locale is not valid or not supported.

Examples

  1. Delete multiple virtual servers
    This example illustrates how to delete a virtual server named "1234" and another virtual server named "server 1".
    smcli rmvs -n 1234,"server 1"
  2. Delete a virtual server and its attached storage
    This example illustrates how to delete the virtual server named "5678" as well as any storage that is attached to it.
    smcli rmvs -n 5678 -s
Parent topic: Virtual servers