HP StoreOnce D2D4324 HP StoreOnce Backup System CLI Reference Guide (BB877-909 - Page 174

vtl move cartridge, not be a command syntax violation.

Get HP StoreOnce D2D4324 PDF manuals and user guides View all HP StoreOnce D2D4324 manuals
Add to My Manuals
Save this manual to your list of manuals

Page 174 highlights

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 |mail |slot }] [barcode ] to [libX] {drive |mail |slot } Command Authority Operator and Administrator Command Object Requirements • SETX - 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. • LIBX - This required object is the virtual tape library into which the cartridge will be moved. X is the numeric index of the library. • CARTX - 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 | mail | slot }] [barcode ] to [libX] {drive | mail | slot }" ◦ Command Failed - The service set is invalid 174 Alphabetical List of Commands and Details

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
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 will be moved. X is the numeric index of the service set.
•
LIB
X
– This required object is the virtual tape library into which the cartridge will be 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 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
174
Alphabetical List of Commands and Details