DEFINE PATH (Define a path when the destination is a library)

Privilege class

To issue this command you must have system privilege or unrestricted storage privilege.

Parameters

source_name (Required)

Specifies the name of source for the path. This parameter is required.

destination_name (Required)

Specifies the name of the destination. This parameter is required.

Attention: To define a path from a NAS data mover to a library, the library must have LIBTYPE of SCSI, 349x, or ACSLS.

SRCType (Required)

Specifies the type of the source. This parameter is required. Possible values are:

DATAMover

Specifies that a data mover is the source.

SERVer

Specifies that a storage agent is the source.

AUTODetect

Specifies whether the serial number for a drive or library will be automatically updated in the database at the time that the path is defined. This parameter is optional. This parameter is only valid for paths defined from the local server to a drive or a library. Possible values are:

No

Specifies that the serial number will not be automatically updated. The serial number is still compared with what is already in the database for the device. The server issues a message if there is a mismatch.

Yes

Specifies that the serial number will be automatically updated to reflect the same serial number that the drive reports to IBM Spectrum® Protect.

Important:

1. If you did not set the serial number when you defined the drive or the library, the server always tries to detect the serial number, and AUTODETECT defaults to YES. If you have previously entered a serial number, then AUTODETECT defaults to NO.
2. The use of AUTODETECT=YES in this command means that the serial number set in the drive or library definition is updated with the detected serial number.
3. Depending on the capabilities of the device, the AUTODETECT parameter may not be supported.

DESTType=LIBRary (Required)

Specifies that a library is the destination. This parameter is required.

DEVIce

Specifies the name of the device as known to the source, or FILE if the device is a logical drive in a FILE library.

The source uses the device name to access the library. See Table 1 for examples.

Table 1. Examples of device names

Source to destination	Example
Server to a library	/dev/lb4 /dev/tsmscsi/lb4 lb4.1
Storage agent to a drive when the drive is a logical drive in a FILE library	FILE
NAS data mover to a library	mc0

The source uses the device name to access the library. See Table 2 for examples.

Table 2. Examples of device names

Source to destination	Example
Server to a library	/dev/tsmscsi/lb4
NAS data mover to a library	mc0

Important:

• For 349X libraries, the alias name is a symbolic name that is specified in the /etc/ibmatl.conf file. For 349X libraries, the alias name is a symbolic name that is specified in the c:\winnt\ibmatl.conf file. For more information, see IBM Tape Device Drivers Installation and User's Guide, which can be downloaded from the IBM® Systems support site at http://www.ibm.com/support/docview.wss?uid=ssg1S7002972.
• For information about how to obtain names for devices that are connected to a NAS file server, consult the product information for the file server. For example, for a NetApp file server, connect to the file server using Telnet and issue the SYSCONFIG command. Use this command to determine device names for drives:

  sysconfig -t

  Use this command to determine the device name for a library:

  sysconfig -m

EXTERNALManager

Specifies the location of the external library manager where IBM Spectrum Protect can send media access requests. Use single quotation marks around the value of this parameter. For example, enter:

/usr/lpp/GESedt-acsls/bin/elmdt

/opt/GESedt-acsls/bin/elmdt

C:\Program Files\GES\EDT-ACSLS\bin\elmdt.exe

This parameter is required when the library name is an external library.

ONLine

Specifies whether the path is available for use. This parameter is optional. The default is YES. Possible values are:

Yes

Specifies that the path is available for use.

No

Specifies that the path is not available for use.

The source and the destination must both be available to use the path.

Attention: If the path to a library is offline, the server will not be able to access the library. If the server is halted and restarted while the path to the library is offline, the library will not be initialized.