Use this command to define a drive that TSM can use to access data on storage volumes. Each drive is assigned to a single library. You must define this library before you issue this command. You can define more than one drive for a given library by issuing the DEFINE DRIVE command once for each drive. Stand-alone drives always require a manual-type library. For additional information, see Administrator's Guide.
Privilege Class
To issue this command, you must have system privilege or unrestricted storage privilege.
Syntax
>>-DEFine DRive--lib_name--drive_name---------------------------> .-ONLine--=--Yes-----. >-----DEVIce--=--device_name----+--------------------+----------> '-ONLine--=--+-Yes-+-' '-No--' >-----+---------------------------+-----------------------------> | (1) | '-ELEMent--=--address-------' >-----+-----------------------------+---------------------------> | (2) | '-ACSDRVID--=--drive_id-------' .-CLEANFREQuency--=--NONE---------. >-----+---------------------------------+---------------------->< '-CLEANFREQuency--=--+-NONE-----+-' +-ASNEEDED-+ '-value----'
Notes:
Parameters
To access a drive that is device type REMOVABLEFILE, use a mount point such as, /cdrom/cdrom0.
For devices other than the IBM 3494, the name is the special file name. For a 3494, the device name is the symbolic name you entered in the configuration file for the library.
During configuration of devices other than the 3494, one or more device
special file names are created. The following table shows the form of
the names. In this table, x denotes a number from 0 to
7.
Special File Name. | Description |
---|---|
/dev/rmt/xmt | Used for tape drives that are supported by the TSM device driver |
/dev/rmt/xlb | Used for SCSI-attached libraries that are supported by the TSM device driver |
/dev/rmt/xop | Used for optical drives that are supported by the TSM device driver |
/dev/rmt/xst | Used for IBM 3490, 3570, and 3590 tape drives, which are supported by the IBMtape device driver |
/dev/rmt/xsmc | Used for the medium changer (the robotics) of an IBM 3570 or an IBM 3590 B11 with Automatic Cartridge Facility (ACF) feature, which are supported by the IBMtape device driver |
Note: | If the device name is a NON-TSM device name (not controlled by an TSM/IBM
tape device driver), perform the following as a precaution to see if TSM can
use this drive as a GENERICTAPE type device.
|
Note: | Use drive cleaning that is controlled by TSM only for SCSI libraries that do not have automatic drive cleaning support in their device hardware. |
Examples
Task
You have already defined a manual tape library named MANLIB by using the DEFINE LIBRARY command. You then now want to inform the server that you have a tape drive that can be used to access storage media. You choose the name TAPEDRIVE3 for this drive.
Task
Define a drive in an ACSLS library with a library name of ACSLIB and a drive name of ACSDRV1 .
Task
Define a drive for a device type of REMOVABLEFILE (CDROM).
Note: | This command uses a UNIX mount point as the device. Refer to the Administrator's Guide for more information. |
Related Commands
Table 60. Commands Related to DEFINE DRIVE
Command | Description |
---|---|
DEFINE LIBRARY | Defines an automated or manual library. |
DELETE DRIVE | Deletes a drive from a library. |
DELETE LIBRARY | Deletes a library. |
QUERY DRIVE | Displays information about drives. |
QUERY LIBRARY | Displays information about one or more libraries. |
UPDATE DRIVE | Changes the attributes of a drive. |