SANDISCOVERY

Edit online

The SANDISCOVERY option specifies whether the IBM® Storage Protect SAN discovery function is enabled.

To use SAN discovery, all devices on the SAN must have a unique device serial number. When set to ON, the server completes SAN discovery in the following instances:
  • When the device path is changed
  • When the QUERY SAN command is issued
Using SAN discovery, the server can automatically correct the special file name for a device if it is changed for a specified tape device.

The IBM Storage Protect server does not require persistent binding with the SAN discovery function enabled. To display a list of devices that are seen by the server, you can issue the QUERY SAN command.

Restriction: 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.

For virtual systems, the SAN discovery operation might not work if the virtual Fibre Channel adapter, Fibre Channel device driver, and HBA API are not available.

Syntax

Read syntax diagramSkip visual syntax diagramSANDISCOVERY=OFFSANDISCOVERY=ONUNSCANNEDPATHOFF

Parameters

ON
Specifies that the server completes SAN discovery when the device path is changed, or when the QUERY SAN command is issued.
OFF
Specifies that the server does not complete SAN discovery when the device path is changed, or when the QUERY SAN command is issued. If the IBM Storage Protect server is not able to open a device, a message is issued but the path that is associated with the device is not taken offline. This value is the default.
UNSCANNEDPATHOFF
Specifies that the server does not complete SAN discovery when the device path is changed, or when the QUERY SAN command is issued. If the IBM Storage Protect server is not able to open a device, a message is issued and the path to the device is taken offline.

Examples

sandiscovery on

Related commands

Table 1. Commands related to SANDISCOVERY
Command Description
PERFORM LIBACTION Defines all drives and paths for a library.