Use this command to define a drive that the server 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--library_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.
See the device special file names in the following table. In this
table, x denotes any number from 1 to 9.
Special File Name | Description |
---|---|
/dev/mtx | Used by all TSM-supported tape drives (not supported by IBM hardware device drivers) |
/dev/lbx | Used by most TSM-supported SCSI libraries |
/dev/ropx | Used by all TSM-supported optical drives |
/dev/rmtx | Used by the GENERICTAPE, 3570, and 3590 device types |
/dev/smcx | Used by 3570 and 3575 libraries, and used to define the Automatic Cartridge Facility feature of the IBM 3590 B11 as a library |
/dev/lmcpx | Used by 349X automatic tape libraries |
/dev/cdx | Used by REMOVABLEFILE device type (CD-ROM) |
/zip | Used by writable REMOVABLEFILE device type (Iomega Zip Drive) |
Note: | Do not use drive cleaning that is controlled by the server for SCSI libraries that have automatic drive cleaning support in their device hardware. |
Consult the drive manufacturer's information 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:
Examples
Task
You have defined a manual tape library that is named MANLIB. You 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.
define drive manlib tapedrive3 device=/dev/mt0
Task
Define a drive in an ACSLS library with a library name of ACSLIB and a drive name of ACSDRV1 .
define drive acslib acsdrv1 device=/dev/mt0 acsdrvid=1,2,3,4
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. |
define drive manlib cdrom device=/cdrom
Related Commands
Table 60. Commands Related to DEFINE DRIVE
Command | Description |
---|---|
DEFINE DRIVEMAPPING | Defines the drive name that will be mapped to the storage agent allowing for direct storage and retrieval of data. |
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. |