VLS9200 user guide (BW402-10009, August 2012)

Table 28 CLI Configuration Commands (continued)
Usage
1
Command
Returns a list of available cartridge emulation types. Displays each cartridge emulation's
name, type, and capacity information. Where the options are:
-l - List only licensed types (optional)
getCartTypes
-h - Displays command usage information (optional)
Returns a list of available cartridge emulation types for the tape drive specified. Displays
each cartridge emulation's name, type, and capacity information. Where the options
are:
-a <s> - Name of tape drive type (required)
getCartTypesByTape
-h - Displays command usage information (optional)
Creates the specified number of cartridges with the specified barcode and associated
with the specified library.
Note: If you specify more cartridges than slots defined for the library, this command only
creates enough cartridges for the slots available. That is, if your library has 100 slots
createCartridge
and you specify 125 total cartridges, this command creates 100 cartridges. Likewise, if
50 cartridges were already created for this library, this command would create only 50
more cartridges, even though 125 are specified by the command.
Where the options are:
-a <s> - Cartridge name (DLT, ...) (required)
-b <s> - Barcode prefix (required)
-c <n> - Capacity in gigabytes (required)
-l <s> - Library name (Library_0, ...) (required)
-n <n> - Number of cartridges (required)
-ov <n> - Oversubscribe (0 or 1) (required)
-s <s> - Storage pool name (StoragePool_#) (optional)
-y <n> - Cartridge type (2, ...) (required)
-h - Displays command usage information (optional)
Returns a list of the cartridges that have been created. All cartridges have both a VLS
filename (cartridge name) and a barcode label. This command returns the following
cartridge metadata:
getCartridges
• Storage pool the cartridge resides (SD_1_0)
• Cartridge VLS filename
• Cartridge capacity (in GB)
• Consumed capacity (in GB)
• Cartridge type
• Timestamp value for when it was last loaded
• Whether or not it is write-enabled (0) or write-protected (1)
• Library to which it belongs
• Barcode label
Returns a list of the cartridges associated with the specified library. Where the options
are:
-a <s> - Name of library (Library_0, ...) (required)
getCartsByLib
-h - Displays command usage information (optional)
Returns the cartridge metadata for the number of cartridges indicated having the specified
barcode. Where options are:
-b<s> - Barcode prefix (required)
getCartsByBarcode
-i<n> - Starting numeric value for the cartridges created with this template (required)
-n <n> - Ending numeric value for the cartridges to retrieve (required)
-h - Displays command usage information (optional)
166 CLI Command Set