Tivoli Storage Manager for Windows: Administrator's Reference

QUERY DRIVE (Query Information about a Drive)

Use this command to display information about a drives.

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    On Line                                            |
|Name      Name     Type                                                         |
|--------  ------   --------  --------                                           |
|AUTO      8MM.0    8MM       YES                                                |
|AUTO      8MM.2    8MM       YES                                                |
|MANUAL    8MM.3    8MM                                                          |
+--------------------------------------------------------------------------------+

Task

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                               |
|                                 ACS DriveId: -                                 |
|                                Allocated To: -                                 |
|              Last Update by (administrator): SERVER_CONSOLE                    |
|                       Last Update Date/Time: 2000-01-13 15:25:03               |
|Cleaning Frequency (Gigabytes/ASNEEDED/NONE): NONE                              |
+--------------------------------------------------------------------------------+

|Task

|Display detailed information about DRIVE1 located in the |network-attached storage library named NASLIB. |

|Command:
|query drive naslib drive1 format=detailed

|Output:
|
|+--------------------------------------------------------------------------------+
||                                Library Name: NASLIB                            |
||                                  Drive Name: DRIVE1                            |
||                                 Device Type: REMOTE                            |
||                                     On Line: Yes                               |
||                                      Device:                                   |
||                                     Element: 1,030                             |
||                                Allocated To:                                   |
||              Last Update by (administrator): SERVER_CONSOLE                    |
||                       Last Update Date/Time: 2001-06-13 15:25:03               |
||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. Exceptions:

|REMOTE
|The only path defined is from a NAS file server.

|UNKNOWN
|No path exists.

Device
The name of the device that corresponds to the drive. |This field is blank if the drive is accessible only by a path from a |NAS file server. The actual device name is displayed by the QUERY PATH |command.

On Line
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
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
The time the server detected a problem and began polling. The time format is: mm/dd/yy hh:mm:ss. The server is polling the drive because the drive stopped responding. The server will poll a drive before stating it is unavailable.

The server 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 server 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
The element address of the drive.

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 178. 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.
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 ]