QUERY DRIVE (Query information about a drive)

Use this command to display information about the drives associated with a library.

Privilege class

Any administrator can issue this command.

Syntax

Parameters

library_name

Specifies the name of the library where the queried drive is located. This parameter is optional. You can use a wildcard character to specify this name.

You must specify a value for this parameter if you specify a drive name.

drive_name

Specifies the name that is assigned to the drive. This parameter is optional. You can use a wildcard character to specify this name. If you specify a drive name, you must also specify a library_name.

Format

Specifies how the information is displayed. This parameter is optional. The default is STANDARD. Possible values are:

Standard: Specifies that partial information is displayed for the drive.
Detailed: Specifies that complete information is displayed for the drive.

Example: List drives associated with the server

Display information about all drives associated with the server. Issue the command:

query drive

Library   Drive    Device   Online
Name      Name     Type
--------  ------   --------  -----
LIB1      DRIVE01  3590       Yes
LIB2      DRIVE02  3590       Yes

See Field descriptions for field descriptions.

Example: List detailed information about a drive

Display detailed information about a drive that is named LTO8DR00 in library 3584LTO8. Issue the command:

query drive 3584lto8 lto8dr00 format=detailed

Library Name: 3584LTO8
Drive Name: LTO8DR00
Device Type: LTO
On-Line: Yes
Read Formats: ULTRIUM8C,ULTRIUM8,ULTRIUM7C,ULTRIUM7
Write Formats: ULTRIUM8C,ULTRIUM8,ULTRIUM7C,ULTRIUM7
Element: 263
Drive State: EMPTY
Volume Name: 
Allocated to: 
WWN: 
Serial Number: 0007823B0B
Last Update by (administrator): DK
Last Update Date/Time: 11/14/2019 05:27:11
Cleaning Frequency (Gigabytes/ASNEEDED/NONE): NONE

See Field descriptions for field descriptions.

Field descriptions

Library Name

The name of the library to which the drive is assigned.

Drive Name

The name that is assigned to the drive.

Device Type

The device type as specified in the associated device class. A path must be defined from the server to the drive so that the server can determine the true device type. If a path is defined from the server to the drive, the server displays the true device type of the drive even if there are other paths defined to this drive. Exceptions to this occur if the device type is remote or unknown.

REMOTE: The server does not have a path to the device. The only defined paths to the device are from data movers.
UNKNOWN: No path exists.

Tip: Review the output of the QUERY PATH command to determine whether the appropriate paths are defined. If they are not defined, define the paths by using the DEFINE PATH command. Also, if using a data mover device, review the output of the QUERY DATAMOVER command to determine the type of the data mover device. If you are using a path from the server to a drive, the device type of the device class and the drive need to match. If you are using a path from a data mover device to a drive, review the documentation for your type of data mover to ensure that the device type of the device class is compatible with the type of data mover device.

On-Line

Specifies the status of the drive:

Yes: The drive is online and available for server operations.
No: The drive is offline and was put in this state by an administrator updating the status.
Unavailable Since: Specifies that the drive has been unavailable since mm/dd/yy hh:mm:ss. Output shows the time that the server marked the drive as unavailable.
Polling Since: Specifies that the server is polling the drive because the drive stopped responding. Output shows the time when the server detected a problem and began polling. The server polls a drive before stating it is unavailable. The time output follows the format: mm/dd/yy hh:mm:ss.

Read Formats

The read formats for the drive.

Write Formats

The write formats for the drive.

Element

The element address of the drive in the tape library. This element address is determined by the tape library firmware. This element address is not shared by drives in a tape library. Each drive has its own element address in a tape library.

Drive State

This specifies the current state of this particular drive based on the result of the last SCSI command to the drive or library. The server tracks the state of the drive to improve its selection of a drive for an operation and its drive recovery operations. The values are:

Unavailable: The drive is not available to the library for operations.
Empty: The drive is empty and ready for operations.
Loaded: The drive is loaded, and the server is performing operations to the drive.
Unloaded: The media was ejected from the drive.
Reserved: The drive is reserved for a mount request.
Unknown: The drive begins in drive state unknown as a result of being defined, as a result of server initialization, or as a result of having its status updated to online.

Volume Name

The volume name for the drive.

Allocated To

The name of the library client that is using the drive. This applies to shared SCSI libraries only; the field is left blank for all other libraries.

WWN

The World Wide Name for the drive.

Serial Number

The serial number of the drive.

Last Update by (administrator)

Who performed the last update to the drive.

Last Update Date/Time

The date and time when the last update occurred.

Cleaning Frequency (Gigabytes/ASNEEDED/NONE)

How often the server activates drive cleaning. This value can be the number of gigabytes, ASNEEDED, or NONE.

Related commands

Table 1. Commands related to QUERY DRIVE
Command	Description
AUDIT LIBRARY	Ensures that an automated library is in a consistent state.
DEFINE DRIVE	Assigns a drive to a library.
DEFINE LIBRARY	Defines an automated or manual library.
DEFINE PATH	Defines a path from a source to a destination.
DELETE DRIVE	Deletes a drive from a library.
DELETE LIBRARY	Deletes a library.
QUERY LIBRARY	Displays information about one or more libraries.
UPDATE DRIVE	Changes the attributes of a drive.