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.
Example:
List drives associated with the server
Display
information about all drives associated with the server. Issue the
command:
query drive
Library Drive Device Online
Name Name Type
-------- ------ -------- -----
LIB1 DRIVE01 3590 Yes
LIB2 DRIVE02 3590 Yes
See
Field descriptions for
field descriptions.
Example: Display detailed
information on a specific
drive and library
Display detailed information about the drive
named DRIVE02 that is associated with the library LIB2. Issue the
command:
query drive lib2 drive02 format=detailed
Library Name: LIB2
Drive Name: DRIVE02
Device Type: 3590
On Line: Yes
Drive State: Empty
ACS DriveID:
Allocated to:
Last Update by (administrator): ADMIN
Last Update Date/Time: 02/29/2002 09:26:23
Cleaning Frequency (Gigabytes/ASNEEDED/NONE): NONE
See
Field descriptions for field descriptions.
Field descriptions
- Library Name
- The name of the library to which
the drive is assigned.
- Drive Name
- The
name assigned to the drive.
- Device Type
- 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 to this occur if the device type is remote or unknown.
- REMOTE
- The server does not have a path to the
device. The only defined
paths to the device are from data movers.
- UNKNOWN
- No path exists.
Tip: 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 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 polls a drive before stating it is unavailable.
The time output follows the format: mm/dd/yy hh:mm:ss.
If your drive is controlled by the Tivoli® Storage
Manager device driver
or the IBM® tape driver, any
device special files created by the Oracle Solaris st device driver
for this drive must be deleted to prevent multiple device drivers
from accessing the drive. If any st device-driver special files for
the drive are detected on the system, the drive is put into polling
state. Error messages are displayed to let you know that the issue
must be resolved before the drive can be used. To fix this issue,
run the rmstdev utility to locate and delete the st device special
files. If the problem is not fixed after one hour, the drive is taken
offline.
- 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.