HP D2D2502i User's Guide download pdf (Page 156)

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

– This required object defines the service set containing the virtual tape library into which

the cartridge will be moved. X is the numeric index of the service set.

• LIB

– This required object is the virtual tape library into which the cartridge will be moved.

X is the numeric index of the library.

• CART

– 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 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.)

• 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 the command syntax.

• All object values must be valid; see the object descriptions for details.

• All parameter values must be valid; see the parameter descriptions 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> |

mail <number> | slot <number>}] [barcode <string>] to [libX]

{drive <number> | mail <number> | slot <number>}”

◦ Command Failed – The service set <SETX> is invalid

156 Alphabetical List of Commands and Details

1 2 ... 151 152 153 154 155 156 157 158 159 160 161 ... 177 178

Comments to this Manuals

No comments

HP D2D2502i User's Guide Page 156

Comments to this Manuals

Related products and manuals for Gateways/controllers HP D2D2502i