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-----------------------> >-----DEVIce--=--device_name----+---------------------------+---> | (1) | '-ELEMent--=--address-------' .-CLEANFREQuency--=--NONE---------. >-----+---------------------------------+---------------------->< '-CLEANFREQuency--=--+-NONE-----+-' +-ASNEEDED-+ '-value----'
Notes:
Parameters
After you configure the device drivers for the tape drives that are supported by the standard HP-UX device drivers, the operating system automatically assigns the special file names during system start-up. A single drive can have multiple special file names, depending on the format and recording density that the drive supports.
Select the device name to use to define the drive to the server. Choose the format and density that you want TSM to use. For example, one device may have all of the following special file names:
The different names represent different recording formats, densities, and operating characteristics such as data compression. You might choose the name /dev/rmt/c1t0d0BEST to have the server use the best recording format and density available on the drive. To see these file names, you can use the HP-UX System Administration Manager (SAM), or use the IOSCAN command. For example, to see the device special files available for tape drives, enter the command:
> /usr/sbin/ioscan -fkn -C tape
The LSSF command can help you get more information about a specific device special file name. See the documentation for your operating system for details about special file names.
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 already defined a manual tape library named MANLIB by using the DEFINE LIBRARY command. 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/rmt/0m
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 52. 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. |