Use this command to obtain information about devices that
can be detected on a storage area network (SAN) so that you can configure Tivoli® Storage
Manager for LAN-free
data movement.
![AIX operating systems](./../common/images/ngaix.gif)
The
QUERY SAN command requires
the
libhbaapi.a that supports SNIA common Host Bus Adapter
(HBA) API. With this library object,
Tivoli Storage
Manager can call
the
hbaapi functions that are specified in the SNIA common
HBAAPI standard.
![Windows operating systems](./../common/images/ngwin.gif)
The
QUERY SAN command
requires the
hbaapi.dll that supports SNIA common Host Bus Adapter
(HBA) API. With this library object,
Tivoli Storage
Manager can call
the
hbaapi functions that are specified in the SNIA common
HBAAPI standard.
![Linux operating systems](./../common/images/nglinux.gif)
![Sun Solaris operating systems](./../common/images/ngsolaris.gif)
The
QUERY SAN command
requires the
libhaapi.so that supports SNIA common Host Bus Adapter
(HBA) API. With this library object,
Tivoli Storage
Manager can call
the
hbaapi functions that are specified in the SNIA common
HBAAPI standard.
The QUERY SAN command might not show all
the devices if the SANDISCOVERY server option is
not set to ON.
Privilege class
Any administrator can issue
this command.
Syntax
![Read syntax diagram](./c.gif)
.-Type--=--Any---------.
>>-Query SAN--+----------------------+-------------------------->
'-Type--=--+-Any-----+-'
+-DRive---+
'-LIBRary-'
.-Format--=--Standard-----.
>--+-------------------------+---------------------------------><
'-Format--=--+-Standard-+-'
'-Detailed-'
Parameters
- Type
- Specifies the type of device that is displayed. This parameter
is optional. The default value is Any. Possible values are:
- Any
- Specifies that any device detected on the SAN is displayed.
- DRive
- Specifies that only drive devices are displayed.
- LIBRary
- Specifies that only library devices are displayed.
- Format
- Specifies the type of information that is displayed. This parameter
is optional. The default value is Standard. Possible values are:
- Standard
- Specifies that the information displayed is summarized.
- Detailed
- Specifies that complete information is displayed.
Tip: The output might not display the
serial number of the device. If this happens, look on the back of
the device or contact the manufacturer of the device.
Example: List drive devices
Display summary
information for drive devices on a SAN. See
Field descriptions for field descriptions.
query san type=drive
Device Type Vendor Product Serial Device
------------- ---------- --------- --------- ----------
LIBRARY STK L180 MPC01000128 /dev/smc1
DRIVE STK 9840D 331001017229 /dev/rmt3
DRIVE Quantum DLT4000 JF62806275 /dev/rmt4
DRIVE Quantum DLT4000 JP73213185 /dev/rmt5
DRIVE STK 9840D 331000028779 /dev/rmt6
Example: Display drive device information
Display
detailed information for all drive devices on a SAN. See
Field descriptions for field descriptions.
query san type=drive format=detailed
Device Type: DRIVE
Vendor: IBM
Product: 03570B02
Serial:
Device: mt10.2.0.3
DataMover: No
Node WWN: 5005076206039E05
Port WWN: 5005076206439E05
Lun: 0
SCSI Port: 3
SCSI Bus: 0
SCSI Target: 10
Field descriptions
- Device Type
- The type of device that is being displayed.
- Vendor
- The name of the device's vendor.
- Product
- The name of the product that is assigned by the vendor.
- Serial
- The serial number of the device.
- Device
- The device special file name.
- Data Mover
- Whether the device is a data mover.
- Node WWN
- The worldwide name for the device.
- Port WWN
- The worldwide name for the device, which is specific to the port
that the device is connected to.
- Lun
- The Logical Unit Number of the device.
- SCSI Port
- The port of the Fibre Channel (or SCSI) Host Bus Adapter.
- SCSI Bus
- The bus of the Host Bus Adapter card.
- SCSI Target
- The target number of the device.
Related commands
Table 1. Commands related to QUERY SANCommand |
Description |
DEFINE DATAMOVER |
Defines a data mover to the Tivoli Storage Manager server. |
DEFINE DRIVE |
Assigns a drive to a library. |
DEFINE LIBRARY |
Defines an automated or manual library. |