HP StoreOnce Backup System CLI Reference Guide

vtl delete library
Description of Command Function
Deletes a virtual tape library.
Command Syntax
vtl delete library SETX LIBX
Command Authority
Administrator
Command Object Requirements
• SET X – This required object defines the service set containing the virtual tape library that is to
be 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 that is to be 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).
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
Prior to executing the command the following message is displayed:
Warning – The cartridge(s) to be deleted may contain data, continue? y
/ n
You must enter a y response for command execution to continue. 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 library
is not deleted, and one of these error messages is displayed:
◦ Command Failed – Did not conform to the correct command syntax
“vtl delete library SETX LIBX”
◦ Command Failed – The service set <SETX> is invalid
◦ Command Failed – The service set <SETX> does not exist
◦ Command Failed – The library <LIBX> is invalid
◦ Command Failed – The library <LIBX> does not exist
◦ Command Failed – the service set must be specified
• If you do not respond to the warning message with y, the command is terminated, and the
CLI returns to the user prompt.
vtl delete library 231