HP StoreOnce Backup System CLI Reference Guide

vtl move cartridge
Description of Command Function
Moves a cartridge within a virtual tape library.
Command Syntax
vtl move cartridge SETX LIBX [CARTX] [from {drive <number>|mail
<number>|slot <number>}] [barcode <string>] to [libX] {drive
<number>|mail <number>|slot <number>}
Command Authority
Operator and Administrator
Command Object Requirements
• SET X – This required object defines the service set containing the virtual tape library into which
the cartridge is moved. 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 into which the cartridge is moved. X is
the numeric index of the library.
• CART X – This optional object is the cartridge to be moved. X is a numeric index which uniquely
defines the cartridge. If not defined, the location of the cartridge to be moved must be defined
in the from or barcode parameter.
Command Parameter Requirements
• barcode – This optional parameter identifies the cartridge to be moved by its barcode. If not
defined, the cartridge to be moved must be defined with the cartridge object or the from
parameter.
• from – This parameter defines the location from which the cartridge is moved. The value for
this parameter is text defining a slot, drive, or mail slot location. The location must exist within
the defined library. If the cartridge object (CARTX) and barcode parameter are not
defined, this parameter is required. If defined, this parameter must appear before the to
parameter. (If this parameter is defined but the text from is missing from the command
sequence, there will not be a command syntax violation.)
• lib
• to – This required parameter defines the location to which the cartridge is moved. The value
is a slot type followed by an integer defining a slot location, drive location, or mail slot. It
must be a location within the given library at which a cartridge does not already exist.
Requirements for Command Execution
• The command entry must conform to command syntax.
• All object values must be valid. See object requirements for details.
• All parameter values must be valid. See parameter 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 cartridge
is not moved and one of these error messages is displayed:
◦ Command Failed – Did not conform to the correct command syntax
“vtl move cartridge SETX LIBX [CARTX] [from {drive <number> |
246 Alphabetical List of Commands and Details