Administrator's Reference

QUERY DRIVE (Query Information about a Drive)

Use this command to display information about a drive located in a server-attached 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 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 DRIVE_NAME, you must also specify a LIBRARY_NAME.

Format
Specifies how the information is displayed. This parameter is optional. The default value 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 1

Display information about all drives associated with your server.

Command:
query drive

Output:

+--------------------------------------------------------------------------------+
|Library   Drive    Device    Device             ON LINE                         |
|Name      Name     Type                                                         |
|--------  ------   --------  -------------      --------                        |
|AUTO      8MM.0    8MM       mt3.0.0.0               YES                        |
|MANUAL    8MM.2    8MM       \\.\Tape0               YES                        |
|                                                                                |
+--------------------------------------------------------------------------------+

See Task 2 for parameter definitions.

Task 2

Display information in full detail about the 8mm drive named DRIVE1 located in the library named AUTO.

Command:
query drive auto drive1 format=detailed

Output:

+--------------------------------------------------------------------------------+
|                   Library Name: AUTO                                           |
|                     Drive Name: DRIVE1                                         |
|                    Device Type: 8MM                                            |
|                         Device: mt3.0.0.0                                      |
|                        ON LINE: Yes                                            |
|                        Element: 116                                            |
| Last Update by (administrator): SERVER_CONSOLE                                 |
|          Last Update Date/Time: 1995-01-13 15:25:03                            |
+--------------------------------------------------------------------------------+

where:

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

Drive Name
Specifies the name assigned to the drive.

Device Type
Specifies the type of device.

Device
Specifies the name of the device that corresponds to the drive.

ON LINE
Specifies the status of the drive:

YES
Specifies that the drive is online and available for TSM operations.

NO
Specifies that the drive is offline and was put in this state by an administrator updating the status.

UNAVAILABLE
Specifies that the drive is unavailable. Output from this query shows the most recent date and time that TSM was able to make contact with the drive. This value is currently used only for drives in 3494 libraries.

Element
Specifies the element address of the drive.

Last Update by (administrator)
Specifies who performed the last update to the drive.

Last Update Date/Time
Specifies the date and time when the last update occurred.

Related Commands

Table 163. Commands Related to QUERY DRIVE

Command Description
AUDIT LIBRARY Ensures that an automated library is in a consistent state.
DEFINE LIBRARY Defines an automated or manual 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 ]