Tivoli Storage Manager for Windows 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. The QUERY DRIVE command can be used to determine the state of a drive, whether it is online, offline, unavailable or being polled by the server.

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 the 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: Polling since 01-13-00 14:15:02                |
|                        Element: 116                                            |
|                   Allocated To: -                                              |
| Last Update by (administrator): SERVER_CONSOLE                                 |
|          Last Update Date/Time: 2000-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 server operations.

No
Specifies that 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. The time output follows the format: mm/dd/yy hh:mm:ss.

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.

The Tivoli Storage Manager will poll a drive under the following conditions:

  1. The drive can read and/or write the required density format for the new tape operation.
  2. The server cannot use the drive. For example, the server cannot open the drive, or there is a volume still loaded in the drive that cannot be unloaded.

The Tivoli Storage Manager will poll the drive for 10 minutes under the following conditions:

  • The drive is in a SCSI or ACSLS library.
  • The drive is in a 3494 library and the 3494 SHARED=YES option is not specified in the dsmserv.opt file.
  • The drive is in a 3494 library and the 3494 SHARED=YES option is specified in the dsmserv.opt file. However, the category of the volume currently loaded in the drive matches the private or scratch category of the library defined to this server.

.

If the server cannot use the drive at the end of the 10 minute period, it will mark the drive off-line. The user should review the activity log and system error logs to determine if there is a hardware problem. After the problem is resolved, the user can update the drive to be on-line via the UPDATE DRIVE command and the ONLINE=YES option.

The server will indefinitely poll a drive in a 3494 library only under the following condition:

  1. The 3494 SHARED=YES option is specified in the dsmserv.opt file.
  2. The drive has a volume loaded.
  3. The category of the volume does not match the private or scratch categories of the 3494 library defined to the server.

If a drive is being polled, the output of the QUERY DRIVE command will show that the drive is being polled and when the polling began. To terminate the polling of a drive, the user can issue one of two commands:

  • UPDATE DRIVE with the ONLINE=NO option
  • DELETE DRIVE

Element
Specifies the element address of the drive.

Allocated To
Specifies 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)
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 166. 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 ]