Tivoli Header
Administrator's Reference
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: 5FE223456D002133 |
| Serial Number: D1234567 |
| 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.
- WWN
- Specifies the Fibre Channel world wide name associated with the
device.
- Serial Number
- Specifies the serial number associated with the 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.
- 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 180. Commands Related to QUERY DRIVE
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]