HP StoreOnce Backup System CLI Reference Guide

vtl delete cartridges
Description of Command Function
Deletes a range of cartridges from a given tape library.
Command Syntax
vtl delete cartridges [SETX] LIBX from SLOT<num> to SLOT<num> [DeleteData
{Yes|No}]
Command Authority
Administrator
Command Object Requirements
• SET X – This object defines the service set containing the virtual tape library from which the
cartridge(s) are deleted. X is the numeric index of the service set. This object must be defined
when the command is used on a multi-node system. The use of this object is optional on a
single node system. If it is used on a single node system, the object must be defined as SET1.
• LIB X – This object is the virtual tape library from which the cartridge(s) is deleted. X is the
numeric index of the library.
Command Parameter Requirements
• from SLOT<num> – This is parameter defines the first slot in the range of slots to be erased.
The value is a slot identifier, and the range is inclusive. No slots in the range can be part of
a replication target mapping.
• to SLOT<num> – This is parameter defines the last slot in the range of slots to be erased. The
value is a slot identifier, and the range is inclusive. No slots in the range can be part of a
replication target mapping.
Requirements for Command Execution
• The command entry must conform to command syntax.
• The defined service set must be valid.
• The defined library must be valid.
• From and To slot numbers must be provided.
• From and To slots must be valid slots in the target library.
• No slots in the range can be replication targets.
Successful Command Output
Before executing the command, the following message is displayed, and then the CLI user prompt
is displayed:
Warning – Any data on the cartridges will be lost, continue? (y/n)
A “y” response must be entered for command execution to continue.
Upon successful completion of the command, the following message is
displayed:
Command Successful
228 Alphabetical List of Commands and Details