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

vtl modify 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 166 highlights

vtl modify cartridge Description of Command Function Modifies the parameters of an existing cartridge. Command Syntax vtl modify cartridge [SETX] LIBX [{CARTX|ALL}] [slot ] [WriteProtect {yes|no}] [barcode ] [CartSize {10|25|50|100|200|400|800|1000|1200|1400|1600|3200}] Command Authority Administrator Command Object Requirements • SETX - This required object defines the service set containing the virtual tape library that contains the cartridge to be modified. X is the numeric index of the service set. • LIBX - This required object is the virtual tape library that contains the cartridge to be modified. 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 optional object is the cartridge to be modified. X is a numeric index which uniquely defines the cartridge. If not defined, the cartridge to be modified must be defined by the slot parameter. Command Parameter Requirements • slot - This optional parameter defines the slot in which the cartridge to be modified is located. The value for this parameter consists of an integer corresponding to the slot location in the virtual tape library. If not defined, the cartridge to be modified must be defined by the CARTX object or the global default ALL. • WriteProtect - This optional parameter determines if the data can only be read from the cartridge. The value is either yes or no. Yes indicates that data cannot be written to the cartridge, and no indicates that data can be written to the cartridge. If not included, the current value remains unchanged. • barcode - This optional parameter consists of a string of characters defining the new barcode to replace the existing barcode on the cartridge. The barcode string must conform to the barcode parameter of the virtual tape library containing the cartridge. If not included, the current value remains unchanged. The parameter cannot be used when the global default ALL is used to define all the cartridges in the library. • CartSize - This optional parameter defines the size in GB to which the cartridges will be modified. The values are defined in the Command Syntax. If not included, the current value remains unchanged. If the cartridges to be modified contain more user data than the defined cartridge size, an error will be generated. 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 166 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 modify cartridge
Description of Command Function
Modifies the parameters of an existing cartridge.
Command Syntax
vtl modify cartridge [SETX] LIBX [{CARTX|ALL}] [slot <num>] [WriteProtect
{yes|no}] [barcode <string>] [CartSize
{10|25|50|100|200|400|800|1000|1200|1400|1600|3200}]
Command Authority
Administrator
Command Object Requirements
•
SET
X
– This required object defines the service set containing the virtual tape library that
contains the cartridge to be modified. X is the numeric index of the service set.
•
LIB
X
– This required object is the virtual tape library that contains the cartridge to be modified.
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 optional object is the cartridge to be modified. X is a numeric index which
uniquely defines the cartridge. If not defined, the cartridge to be modified must be defined
by the
slot
parameter.
Command Parameter Requirements
•
slot
– This optional parameter defines the slot in which the cartridge to be modified is located.
The value for this parameter consists of an integer corresponding to the slot location in the
virtual tape library. If not defined, the cartridge to be modified must be defined by the CART
X
object or the global default ALL.
•
WriteProtect
– This optional parameter determines if the data can only be read from the
cartridge. The value is either
yes
or
no
.
Yes
indicates that data cannot be written to the
cartridge, and
no
indicates that data can be written to the cartridge. If not included, the current
value remains unchanged.
•
barcode
– This optional parameter consists of a string of characters defining the new barcode
to replace the existing barcode on the cartridge. The barcode string must conform to the
barcode parameter of the virtual tape library containing the cartridge. If not included, the
current value remains unchanged. The parameter cannot be used when the global default ALL
is used to define all the cartridges in the library.
•
CartSize
– This optional parameter defines the size in GB to which the cartridges will be
modified. The values are defined in the Command Syntax. If not included, the current value
remains unchanged. If the cartridges to be modified contain more user data than the defined
cartridge size, an error will be generated.
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
166
Alphabetical List of Commands and Details