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, 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:
Use this command to determine the device name for a library:sysconfig -t
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:
/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](./../common/images/ngaix.gif)
define path saturn scsilib srctype=server
desttype=library device=/dev/lb3
![HP-UX operating systems](./../common/images/nghpux.gif)
define path saturn scsilib srctype=server
desttype=library device=/dev/rmt/tsmlb3
![Linux operating systems](./../common/images/nglinux.gif)
define path saturn scsilib srctype=server
desttype=library device=/dev/tsmscsi/lb3
![Oracle Solaris operating systems](./../common/images/ngsolaris.gif)
define path saturn scsilib srctype=server
desttype=library device=/dev/rmt/lb3
![Windows operating systems](./../common/images/ngwin.gif)
define path saturn scsilib srctype=server
desttype=library device=lb3.0.0.0