QUERY SAN (Query the devices on the SAN)

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.

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.

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.

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


              .-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 SAN
Command	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.