IBM Tivoli Storage Manager, Version 7.1

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

Use this syntax when defining a path to a library.

Privilege class

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

Syntax


>>-DEFine PATH--source_name--destination_name------------------->

                           (1)                                 
>--SRCType--=--+-DATAMover-----+--+------------------------+---->
               '-SERVer--------'  '-AUTODetect--=--+-No--+-'   
                                                   '-Yes-'     

>--DESTType--=--LIBRary--+-DEVIce--=--device_name--------+------>
                         '-EXTERNALManager--=--path_name-'   

   .-ONLine--=--Yes-----.   
>--+--------------------+--------------------------------------><
   '-ONLine--=--+-Yes-+-'   
                '-No--'

Notes:

DATAMOVER only applies to NAS devices.

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 Tivoli® Storage Manager.

Important:

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.
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.
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` `/dev/rmt/4lb` `/dev/rmt/tsmlb4` `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, refer to the IBM Tape Device Drivers Installation and User’s Guide. The guide can be downloaded from the IBM® Systems support site at the following URL: 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 Tivoli Storage Manager can send media access requests. Use single quotation marks around the value of this parameter. For example, enter:

AIX operating systems

/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.

Example: Define a path from a server to a library

Define a path from the server SATURN to the SCSI type library SCSILIB:

AIX operating systems

define path saturn scsilib srctype=server 
desttype=library device=/dev/lb3

define path saturn scsilib srctype=server 
desttype=library device=/dev/rmt/tsmlb3

define path saturn scsilib srctype=server 
desttype=library device=/dev/tsmscsi/lb3

define path saturn scsilib srctype=server 
desttype=library device=/dev/rmt/lb3

define path saturn scsilib srctype=server 
desttype=library device=lb3.0.0.0

Feedback