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

vtl delete cartridge

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 162 highlights

vtl delete cartridge Description of Command Function Deletes a single cartridge or all cartridges from a virtual tape library. Command Syntax vtl delete cartridge [SETX] LIBX [{CARTX|ALL}] [barcode ] [mail ] [slot ] Command Authority Administrator Command Object Requirements • SETX - This object defines the service set containing the virtual tape library from which the cartridge will be deleted. X is the numeric index of the service set. • LIBX - This required object is the virtual tape library from which the cartridge will 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. You can find the LIBX object name for a library using the "vtl show library list" (page 188) command. • CARTX - This object is the virtual cartridge to be deleted. X is a numeric index which uniquely defines the cartridge. You can use the global default "ALL" to delete all the cartridges in the defined virtual library. If not defined, use another parameter to define the cartridge to delete. Command Parameter Requirements • barcode - This optional parameter defines the barcode label of the cartridge to be deleted. The value is a character string which matches a barcode label of a cartridge in the virtual library. If this parameter is not defined, another parameter must be used to define the cartridge to be deleted from the virtual library. • mail - This optional parameter defines the mail slot location of the cartridge to be deleted. The value is a number which matches a mail slot location which contains a cartridge in the virtual library. If this parameter is not defined, another parameter must be used to define the cartridge to be deleted from the virtual library. • slot - This optional parameter defines the slot location of the cartridge to be deleted. The value is a number which matches a slot location which contains a cartridge in the virtual library. If this parameter is not defined, another parameter must be used to define the cartridge to be deleted from the virtual library. 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 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 162 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 delete cartridge
Description of Command Function
Deletes a single cartridge or all cartridges from a virtual tape library.
Command Syntax
vtl delete cartridge [SETX] LIBX [{CARTX|ALL}] [barcode <string>] [mail
<number>] [slot <number>]
Command Authority
Administrator
Command Object Requirements
•
SET
X
– This object defines the service set containing the virtual tape library from which the
cartridge will be deleted. X is the numeric index of the service set.
•
LIB
X
– This required object is the virtual tape library from which the cartridge will 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. You can
find the LIB
X
object name for a library using the
“vtl show library list” (page 188)
command.
•
CART
X
– This object is the virtual cartridge to be deleted. X is a numeric index which uniquely
defines the cartridge. You can use the global default “ALL” to delete all the cartridges in the
defined virtual library. If not defined, use another parameter to define the cartridge to delete.
Command Parameter Requirements
•
barcode
– This optional parameter defines the barcode label of the cartridge to be deleted.
The value is a character string which matches a barcode label of a cartridge in the virtual
library. If this parameter is not defined, another parameter must be used to define the cartridge
to be deleted from the virtual library.
•
mail
– This optional parameter defines the mail slot location of the cartridge to be deleted.
The value is a number which matches a mail slot location which contains a cartridge in the
virtual library. If this parameter is not defined, another parameter must be used to define the
cartridge to be deleted from the virtual library.
•
slot
– This optional parameter defines the slot location of the cartridge to be deleted. The value
is a number which matches a slot location which contains a cartridge in the virtual library. If
this parameter is not defined, another parameter must be used to define the cartridge to be
deleted from the virtual library.
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
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
162
Alphabetical List of Commands and Details