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 IBM Spectrum Protect 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, IBM Spectrum Protect 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, IBM Spectrum Protect 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, IBM Spectrum Protect can call the hbaapi functions that are specified in the SNIA common HBAAPI standard.

Restrictions:

The QUERY SAN command might not show all the devices if the SANDISCOVERY server option is not set to ON.
If tape devices are zoned together with disk devices, the SAN discovery operation skips discovery of tape devices when the first detected device is a disk device from a port on a Fibre Channel. If all tape devices are zoned with disk devices, the tape devices are not found when you issue the QUERY SAN command. The following messages are displayed:
```
ANR2034E QUERY SAN: No match found using this criteria.
ANS8001I Return code 11.
```
If the first device on the device mapping from the Fibre Channel port is a tape, either a full or partial list of tape devices is displayed when you issue the QUERY SAN command. The number of tape devices displayed depends on how the tape devices are zoned.

Privilege class

Any administrator can issue this command.

Syntax

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 Number:    
                         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 Number: 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 IBM Spectrum Protect server.
DEFINE DRIVE	Assigns a drive to a library.
DEFINE LIBRARY	Defines an automated or manual library.