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

vtl show cartridges, Upon successful completion of the command

Page 178 highlights

vtl show cartridges Description of Command Function Displays information about the cartridges in a given library. Command Syntax vtl show cartridges SETX LIBX Command Authority Operator and Administrator Command Object Requirements • SETX - This required object defines the service set containing the virtual library to be described. X is the numeric index of the service set. If not defined, the capacity information is provided at the cluster level. • LIBX - This required object is the virtual tape library that contains the cartridge to be described. X is the numeric index of the library. 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 Upon successful completion of the command, the cartridge information is displayed. Command Operation during Abnormal Conditions If any of the command execution requirements fail, command execution terminates. The cartridge information is not displayed and one of these error messages is displayed: • Command Failed - Did not conform to the correct command syntax "vtl show cartridges 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 Examples # vtl show cartridges SET1 LIB1 Library : LIB1 Name: Gregslib Object Location Slot CART1 1 CART2 2 Barcode ------ABC001YZ ABC002YZ Max Size -------- 800 GB 800 GB User Data --------- 745 GB 712 GB Protected --------- yes yes Mapped ------ no no CART3 Drive2 3 ABC003YZ 800 GB 799 GB yes no CART4 4 ABC004YZ 800 GB 785 GB yes no CART5 5 ABC005YZ 800 GB 455 GB yes no CART6 6 ABC006YZ 800 GB 601 GB yes no CART7 9 ABC007YZ 800 GB 100 GB yes no CART8 8 ABC008YZ 800 GB 767 GB yes no CART9 7 ABC009YZ 800 GB 35 GB yes no Command Successful # vtl show cartridges SET1 LIB1 178 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 show cartridges
Description of Command Function
Displays information about the cartridges in a given library.
Command Syntax
vtl show cartridges SETX LIBX
Command Authority
Operator and Administrator
Command Object Requirements
SET
X
– This required object defines the service set containing the virtual library to be described.
X is the numeric index of the service set. If not defined, the capacity information is provided
at the cluster level.
LIB
X
– This required object is the virtual tape library that contains the cartridge to be described.
X is the numeric index of the library.
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
Upon successful completion of the command, the cartridge information is displayed.
Command Operation during Abnormal Conditions
If any of the command execution requirements fail, command execution terminates. The cartridge
information is not displayed and one of these error messages is displayed:
Command Failed
Did not conform to the correct command syntax
vtl
show cartridges 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
Examples
# vtl show cartridges SET1 LIB1
Library : LIB1
Name: Gregslib
Object
Location Slot
Barcode
Max Size
User Data
Protected
Mapped
------
-------- ----
-------
--------
---------
---------
------
CART1
1
ABC001YZ
800 GB
745 GB
yes
no
CART2
2
ABC002YZ
800 GB
712 GB
yes
no
CART3
Drive2
3
ABC003YZ
800 GB
799 GB
yes
no
CART4
4
ABC004YZ
800 GB
785 GB
yes
no
CART5
5
ABC005YZ
800 GB
455 GB
yes
no
CART6
6
ABC006YZ
800 GB
601 GB
yes
no
CART7
9
ABC007YZ
800 GB
100 GB
yes
no
CART8
8
ABC008YZ
800 GB
767 GB
yes
no
CART9
7
ABC009YZ
800 GB
35 GB
yes
no
Command Successful
# vtl show cartridges SET1 LIB1
178
Alphabetical List of Commands and Details