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


                .-*--*-------------------------.   
>>-Query DRive--+------------------------------+---------------->
                |               .-*----------. |   
                '-library_name--+------------+-'   
                                '-drive_name-'     

   .-Format--=--Standard-----.   
>--+-------------------------+---------------------------------><
   '-Format--=--+-Standard-+-'   
                '-Detailed-'

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 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: Display detailed information on a specific drive and library

Display detailed information about the drive named DRIVE02 that is associated with the library LIB2. Issue the command:

query drive lib2 drive02 format=detailed

                                Library Name: LIB2
                                  Drive Name: DRIVE02
                                 Device Type: 3590
                                     On Line: Yes
                                 Drive State: Empty
                                 ACS DriveID:
                                Allocated to:
              Last Update by (administrator): ADMIN
                       Last Update Date/Time: 02/29/2002 09:26:23
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 assigned to the drive.

Device Type

The device type as specified in the associated device class. The server must have a path defined from the server to the drive in order to determine the true device type. As long as there is a path defined from the server to the drive, the server will display 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 if the desired paths are defined. If they are not defined, define those desired paths 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 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 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 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.
If your drive is controlled by the Tivoli® Storage Manager device driver or the IBM® tape driver, any device special files created by the Oracle Solaris st device driver for this drive must be deleted to prevent multiple device drivers from accessing the drive. If any st device-driver special files for the drive are detected on the system, the drive is put into polling state. Error messages are displayed to let you know that the issue must be resolved before the drive can be used. To fix this issue, run the rmstdev utility to locate and delete the st device special files. If the problem is not fixed after one hour, the drive is taken offline.

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 currently loaded, and the server is performing operations to the drive.
Unloaded: The media has been 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.

ACS DriveId

The ID that specifies the physical location of the drive in an ACSLS library. This drive ID is specified as a,l,p,d, where a is the ACSID, l is the LSM (library storage module), p is the panel number, and d is the drive ID.

Allocated To

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

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

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

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.