IBM Tivoli Storage Manager, Version 7.1

UPDATE PATH (Change a path when the destination is a library)

Use this syntax when updating a path definition to a library.

Privilege class

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

Syntax


>>-UPDate PATH--source_name--destination_name------------------->

>--SRCType--=--+-DATAMover-+--+------------------------+-------->
               '-SERVer----'  '-AUTODetect--=--+-No--+-'   
                                               '-Yes-'     

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

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

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.

Important: To define a path from a NAS data mover to a library, the library must have LIBTYPE of SCSI, 349X, or Automated Cartridge System Library Software (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 server or a storage agent is the source.

AUTODetect

Specifies whether the serial number for a drive or library is automatically detected, reported, and updated in Tivoli® Storage Manager. This parameter is optional. This parameter is only valid for paths defined from the local server to a library. Possible values are:

No

Specifies that the serial number is not automatically updated.

Yes

Specifies that the serial number is automatically updated to reflect the same serial number that the drive reports to Tivoli Storage Manager.

Important:

If you have not previously entered a serial number, then AUTODETECT defaults to YES. If you have previously entered a serial number, then AUTODETECT defaults to NO.
AUTODETECT=YES in this command overrides the serial number set in the DEFINE DRIVE command.
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 drive or 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`
NAS data mover to a library	`mc0`

The source uses the device name to access the drive or 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`

The source uses the device name to access the drive or library. See Table 3 for examples.

Table 3. Examples of device names
Source to destination	Example
Server to a library	`lb4.1`
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 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 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. 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.

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

Feedback