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

vtl delete library

Page 164 highlights

vtl delete library Description of Command Function Deletes a virtual tape library. Command Syntax vtl delete library SETX LIBX Command Authority Administrator Command Object Requirements • SETX - This required object defines the service set containing the virtual tape library that will be deleted. X is the numeric index of the service set. • LIBX - This required object is the virtual tape library that 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. Command Parameter Requirements Not applicable - no parameters exist within this command. 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. 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 Command Operation during Abnormal Conditions • If any of the command execution requirements fail, command execution terminates. The library is not deleted and one of these error messages is displayed: ◦ Command Failed - Did not conform to the correct command syntax "vtl delete library SETX LIBX" ◦ Command Failed - The service set is invalid ◦ Command Failed - The service set does not exist ◦ Command Failed - The library is invalid ◦ Command Failed - The library does not exist ◦ Command Failed - the service set must be specified • If you do not respond to the warning message with y, the command is terminated and the CLI returns to the user prompt. Example # vtl delete library LIB4 164 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 library
Description of Command Function
Deletes a virtual tape library.
Command Syntax
vtl delete library SETX LIBX
Command Authority
Administrator
Command Object Requirements
SET
X
– This required object defines the service set containing the virtual tape library that will
be deleted. X is the numeric index of the service set.
LIB
X
– This required object is the virtual tape library that 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.
Command Parameter Requirements
Not applicable – no parameters exist within this command.
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.
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
Command Operation during Abnormal Conditions
If any of the command execution requirements fail, command execution terminates. The library
is not deleted and one of these error messages is displayed:
Command Failed
Did not conform to the correct command syntax
vtl delete library SETX LIBX
Command Failed
The service set <SETX> is invalid
Command Failed
The service set <SETX> does not exist
Command Failed
The library <LIBX> is invalid
Command Failed
The library <LIBX> does not exist
Command Failed
the service set must be specified
If you do not respond to the warning message with
y
, the command is terminated and the CLI
returns to the user prompt.
Example
# vtl delete library LIB4
164
Alphabetical List of Commands and Details