detect -q

You can use either detect -q or detect --query. They are different formats of the same command.

As the first step to every manual tape library installation on the above platforms, you should run the following on your tape library controller node:

detect -q

detect -q gathers and displays information about media changers and tape drives that are accessible from the node on which you are running Detect. detect -q does not create or install any new devices and does not modify any files. Thus, it is always safe to run Detect with the -q command line option. The following is an example of output from detect -q:

SCSI Devices found:

------------------

Device       Adapter     Target            Device

ID           ID      BUS ID     LUN STATUS Type                     String

------------ ------- --- ------ --- ------ ------------------------ -------------

\\.\Tape0    2       0   0      2   0      Sequential Access Device SONY    SDX-500C

\\.\Tape1    2       0   0      5   0      Sequential Access Device HP      Ultrium 1

\\.\sync_sa0 2       0   1      3   0      Media Changer Device     BHTi    216

\\.\Tape2    2       0   1      1   0      Sequential Access Device QUANTUM DLT8000

Device                    Serial / Unique                                    

ID                        Number / Id              World Wide Name           Auto

------------------------- ------------------------ ------------------------- ----

\\.\Tape0                 0000902585               20 0 0 50 13 b0 78 94     Yes

\\.\Tape1                 0000911832               20 0 0 50 13 b0 78 94     Yes

\\.\sync_sa0              216B10                                             Yes

\\.\Tape2                 PXB34P3669               20 0 0 50 13 b0 78 94     Yes

Note that the output contains two tables. The rows in both tables are identified by the Device ID field. The device representing the media changer is identified by Media Changer Device or simply Medium in the Device Type field. So, in the tables above, the third row (\\.\sync_sa0) is the row representing the media changer.

The output displayed above is for a Windows platform, but the content would be similar on any platform. (For Solaris, a freshly connected tape library might not be detected by detect -q, in which case you should use detect -i as described in the next chapter). The following describes the fields (columns) in the output from detect -q, specifically with regard to the media changer device:

Device ID	The file handle of the device driver for this particular device.
Adapter ID	The adapter associated with this device.
BUS	The bus number on this adapter. One adapter may have more than one bus.
Target ID	SCSI Target identifier (SCSI ID).
LUN	Logical Unit Number.
Status	Status values may have different meanings for different platforms. In general, 0 = no problems. Other values are described below, by platform. For Windows: -1 Media Changer: device has already been claimed by another driver. Tape Drive: Detect has failed to acquire a handle for device. -2 Media Changer: Unit attention required. Tape Drive: device is not claimed by a driver and thus is unusable by the OS. -3 Device will not report unique IDs of its tape drives, but still could be used. -16 Library may be claimed by a driver on a 64-bit system. For Solaris: -3 Device will not report unique IDs of its tape drives, but still could be used. -5 I/O Error. -16 Device Busy. For Linux: -1 Media Changer: device has not responded properly on a SCSI inquiry command. Tape Drive: drive is not loaded. -3 Device will not report unique IDs of its tape drives, but still could be used. For HP-UX: -1 The media changer or a tape drive has not responded on a SCSI inquiry command. For AIX: -1 The media changer or a tape drive failed to open.
Device Type	The type of device, according to SCSI-2 specifications.
String	Vendor and product identification information.
Serial Number/Unique ID	Unique identifier assigned to a device by the vendor or agency (for example, ANSI or SNIA).
World Wide Name	A 64-bit number, assigned by IEEE, used to identify a product. It is often used as a port number on Fibre Channel networks.
DPX Auto	Flag indicating whether the Auto-Configuration utility can be applied to this device.

Note that the Detect output does not have a specific field indicating whether the device is claimed. However, if the appropriate driver does not claim a device, its name will not appear in the Device ID column and -1 will appear in the status column.