HP StoreOnce Backup System CLI Reference Guide

vtl delete drive
Description of Command Function
Deletes a virtual drive from a virtual tape library.
Command Syntax
vtl delete drive [SETX] LIBX DRVX
Command Authority
Administrator
Command Object Requirements
• SET X – This required object defines the service set containing the virtual tape library from
which the drive is deleted. X is the numeric index of the service set. It is optional on a
single-node system but must be defined on a multi-node system. If used on a single-node system,
the object must be defined as SET1.
• LIB X – This required object is the virtual tape library from which the drive is deleted. X is the
numeric index of the library.
NOTE: This is the library object name, not the user-defined name of the library. Locate the
LIBX object name for a library using the vtl show library list command (see “vtl show
library list” (page 260) for more information).
• DRV X – This required object is the drive to be deleted. X is a numeric index which uniquely
defines the drive.
Command Parameter Requirements
Not applicable – no parameters exist within this command.
Requirements for Command Execution
• The command entry must conform to command syntax.
• All object values must be valid. See object requirements for details.
Successful Command Output
Upon successful completion of the command, the following is displayed:
Command Successful
Command Operation during Abnormal Conditions
If any of the command execution requirements fail, command execution terminates, the drive is
not deleted from the library and one of these error messages is displayed:
• Command Failed – Did not conform to the correct command syntax “vtl
delete drive [SETX] LIBX DRVX”
• Command Failed – The service set <SETX> is invalid
• Command Failed – The library <LIBX> is invalid
• Command Failed – The drive <DRVX> does not exist in the library
• Command Failed – the drive contains a cartridge
Example
# vtl delete drive SET3 LIB4 DRV2
Command Successful
230 Alphabetical List of Commands and Details