Use this command to define a drive. Each drive is assigned to a library, and so the library must be defined before you issue this command.
A path must be defined after you issue the DEFINE DRIVE command to make the drive usable by Tivoli® Storage Manager software. For more information, see DEFINE PATH (Define a path). If you are using a SCSI or VTL library type, see PERFORM LIBACTION (Define or delete all drives and paths for a library).
You can define more than one drive for a library by issuing the DEFINE DRIVE command for each drive. Stand-alone drives always require a manual library.
To issue this command, you must have system privilege or unrestricted storage privilege.
>>-DEFine DRive--library_name--drive_name-----------------------> .-SERial--=--AUTODetect--------. .-ONLine--=--Yes-----. >--+------------------------------+--+--------------------+-----> '-SERial--=--+-AUTODetect----+-' '-ONLine--=--+-Yes-+-' '-serial_number-' '-No--' (1) .-ELEMent--=--AUTODetect-----. >--+----------------------------+-------------------------------> '-ELEMent--=--+-AUTODetect-+-' '-address----' >--+---------------------------+--------------------------------> | (2) | '-ACSDRVID--=--drive_id-----' >--+-----------------------------------------+----------------->< | (3) | '-CLEANFREQuency--=------+-NONE---------+-' | (4) | +-ASNEEDED-----+ '-gigabytes----'
If SERIAL=AUTODETECT, then the serial number reported by the drive when you define the path is used as the serial number.
If SERIAL=serial_number, then the serial number that is entered is used to verify that the path to the drive is correct when you define the path.
If ELEMENT=AUTODETECT, then the element number is automatically detected by Tivoli Storage Manager when the path to the drive is defined.
To find the element address for your library configuration, consult the information from the manufacturer.
If you are using library-based cleaning, NONE is advised when your library type supports this function.
This parameter is not valid for externally managed libraries, such as 3494 libraries or StorageTek libraries that are managed under ACSLS.
The CLEANFREQUENCY=ASNEEDED parameter value does not work for all tape drives. See the Supported Devices website for your operating system to view detailed drive information. If ASNEEDED is not supported, you can use the gigabytes value for automatic cleaning.
For IBM 3592 and LTO drives, library-based cleaning is advised. If library-based cleaning is not supported, then ASNEEDED must be used. Gigabytes is not recommended.
Consult the information from the drive manufacturer for cleaning recommendations. If the information gives recommendations for cleaning frequency in terms of hours of use, convert to a gigabytes value by doing the following:
Using the cleaning frequency that is recommended by IBM® for IBM drives ensures that the drives are not overcleaned.
For IBM 3590 drives, specify a gigabyte value for the cleaning frequency to ensure that the drives receive adequate cleaning.
define drive lib01 drive01
define path server01 drive01 srctype=server desttype=drive
library=lib01 device=/dev/rmt0
define path server01 drive01 srctype=server desttype=drive
library=lib01 device=dev/rmt/tsmmt0
define path server01 drive01 srctype=server desttype=drive
library=lib01 device=/dev/tsmscsi/mt0
define path server01 drive01 srctype=server desttype=drive
library=lib01 device=/dev/rmt/0mt
define path server01 drive01 srctype=server desttype=drive
library=lib01 device=mt3.0.0.0
define drive acslib acsdrv1 acsdrvid=1,2,3,4
define path server01 acsdrv1 srctype=server desttype=drive
library=acslib device=/dev/rmt0
define path server01 acsdrv1 srctype=server desttype=drive
library=acslib device=/dev/rmt/4m
define path server01 acsdrv1 srctype=server desttype=drive
library=acslib device=/dev/tsmscsi/mt0
define path server01 acsdrv1 srctype=server desttype=drive
library=acslib device=/dev/rmt/0mt
define path server01 acsdrv1 srctype=server desttype=drive
library=acslib device=mt3.0.0.0
define drive auto8mmlib drive01 element=82
define path server01 drive01 srctype=server desttype=drive
library=auto8mmlib device=/dev/rmt0
define path server01 drive01 srctype=server desttype=drive
library=auto8mmlib device=/dev/rmt/4m
define path server01 drive01 srctype=server desttype=drive
library=auto8mmlib device=/dev/tsmscsi/mt0
define path server01 drive01 srctype=server desttype=drive
library=auto8mmlib device=/dev/rmt/0mt
define path server01 drive01 srctype=server desttype=drive
library=auto8mmlib device=mt3.0.0.0
Command | Description |
---|---|
DEFINE LIBRARY | Defines an automated or manual library. |
DEFINE PATH | Defines a path from a source to a destination. |
DELETE DRIVE | Deletes a drive from a library. |
DELETE LIBRARY | Deletes a library. |
PERFORM LIBACTION | Defines all drives and paths for a library. |
QUERY DRIVE | Displays information about drives. |
QUERY LIBRARY | Displays information about one or more libraries. |
QUERY PATH | Displays information about the path from a source to a destination. |
UPDATE DRIVE | Changes the attributes of a drive. |
UPDATE PATH | Changes the attributes associated with a path. |