List drives

tcmgr drive list – show a list of all tape drives in all tape libraries within the system

`SYNOPSIS`

tcmgr drive list [--filter ATTRIBUTE-NAME=ATTRIBUTE-VALUE]

`DESCRIPTION`

Shows a list of all drives installed in all tape libraries within the IBM IBM Deep Archive system.

`OPTIONS`

-f, --filter

Allows filtering of a given attribute.

-h, --help

Display this help and exit.

`PARAMETERS`

-

`EXAMPLES`

This example shows the drives installed in the IBM IBM Deep Archive system.

$ tcmgr drive list
Date/Time: April 28, 2023, 3:44:18 PM -07:00; IBM TapeCloud Version: 1.0.0.0
SN          State        Library  VOLSER    Product
===================================================
607BBFFFF2  mounted            1  F31356L9  LTO 9  
607BBFFFF3  in_use             1  F34044L9  LTO 9  
607BBFFFF4  not_mounted        1  -         LTO 9

`ATTRIBUTES`

The description of the attributes for tcmgr drive list command are as follows:

Table 1. Description of the attributes for tcmgr drive list command
Attribute	Explanation
SN	The globally unique serial number of the tape drive.
State	The health status of the tape drive. See the tcmgr drive show command for details.
Library	The unique ID of the tape library the tape drive is installed in.
VOLSER	The VOLSER of the cartridge mounted in the tape drive. This is `–` if the tape drive does not have a cartridge mounted and unknown if a cartridge is present but its VOLSER is not known.
Product	The product name of the tape drive. Currently only LTO- 9 is supported.