Tivoli Header

Administrator's Reference

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.

Examples

Task

Display information about all drives associated with the server.

Command:
query drive

Output:
+--------------------------------------------------------------------------------+
|Library   Drive    Device   Online                                              |
|Name      Name     Type                                                         |
|--------  ------   --------  -----                                              |
|LIB1      RMT0     3590       Yes                                               |
|LIB2      RMT1     3590       Yes                                               |
|                                                                                |
+--------------------------------------------------------------------------------+

Task

Display detailed information about the drive named RMT1 that is associated with the library LIB2.

Command:
query drive lib2 rmt1 format=detailed

Output:
+--------------------------------------------------------------------------------+
|                                Library Name: LIB2                              |
|                                  Drive Name: RMT1                              |
|                                 Device Type: 3590                              |
|                                         WWN:                                   |
|                               Serial Number:                                   |
|                                     On Line: Yes                               |
|                                 Drive State: Empty                             |
|                                 ACS DriveID:                                   |
|                                Allocated to:                                   |
|              Last Update by (administrator): ADMIN                             |
|                       Last Update Date/Time: 02/29/2000 09:26:23               |
|Cleaning Frequency (Gigabytes/ASNEEDED/NONE): NONE                              |
+--------------------------------------------------------------------------------+

where:

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

Drive Name
The name assigned to the drive.

Device Type
In most cases, 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:

REMOTE
There are only paths to data mover devices.

UNKNOWN
No path exists.
Note:
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 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 will poll a drive before stating it is unavailable. The time output follows the format: mm/dd/yy hh:mm:ss.

For more information on conditions under which the server will poll, see Administrator's Guide.

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 177. 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.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]